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Introduction 



1-1 PRESENTATION 



Voire nouvelle carte "eve^- pour Apple lie a de muitiples fonctions ; 

— Visualisation texts surSO colonnes [au lieu de 40). 

— Extension memoire (memoire utilisateur portee de 64K a 128K). 

— Visualisation couleur sur votre televiseur par la prise P^RITEL. 

— Extension des posEibilites graphiques de votre Apple lie. 

II est possible d'utiliser simultanemeni la sortie p£RITEL de votre 
carte eve sur votre televiseur et la sortie video standard de I'Apple //e 
sur un monileur monochrome. 

Un moniteur couleur RVS peut §tre utilise sous certaines conditions 
(consulter a ce sujet le chapitre IX) 

Tous les programmes con^us pour Apple He fonctjonnenl directement, 
jIs utiiisent eventuellement la visualisation du texte en 80 colonnes, 
roxttjnsion memoire 6dK ot Ics possibilites graphiques standard 
de I'Apple llB. 

Ce manuel est accompagne de deux disquettes correspondant aux 
logiciels d'expioiiation en Basic Applesoft el en Pascaf 1.1 permettant 

d'acceder facilement aux extensions graphiques specifiques a la 
carte eve. 

Vous pourrez obtenir quelques InforrTiations complelant ce manuel 
en executant le programme Basic INFORMATION present sur la 
disquelte DOS 3,3 PURPLESOFT. 



1-2 COMMENT UTILISER CE MANUEL ? 

Nous esperons que ce mar^uei saura reponcfre a toutes les questions 
que V0U3 eles en droil de vous poser au sujet de votre carlo -eve", 
Meanmoins, nous savons que votre pratique de I'ordrnateur individuel 
et plus generalement de la r-nlcro-infomnatique peut varier du tout au 
rien en fonctiondu temps dont vous disposezetde ce que vousattendez 
d un lei ouliJ. 
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Amsi, nous pouvons distinguer grossierement trois categories 
d'utilisateurs : 

— Ceux pour qui lAPPLE lis et la carte «eve-. ne sont qu'un moyen 
efficace d'utiliser au mieux des logiciels professionnets et autrea 
congus en fonction de ce support si vous etes dans ce cas, il vous 
faut iire au minimum le chapitre "fnstallatiori" Par curiosite vous 
pouvez, bien entendu, lire les chapitres d'interet general; celui sur 
le graphisme par exemple. 




Ce sigie est piace en marge des paragrapiies comprehensibles 
par tou$.. Ce qui no veut pas dire quits sont sans interet !! 

— Les debutants devronl commencerparassimiler une comprehension 
miniiTium de leur macl^jne en consifltant attentivement le -guide 
de I'utilisateur- et fe manuel Apple correspondant au langage 
informatique choisi : parexemple fe manuel de reference 
APPLESOFT ou les manuels fournis avec le systeme Pascal, 

Dans un second temps, ils pourront alors utiliser fe logiciei Basic 
"PURPLESOFT" ou bien I'unite Pascal " PURPLEGRAPHICS« g^ranE 
les modes texles et graphjques propres a la carte « ^ve ". 





Et bien entendu, nous n'intsrdisons pas a I'athlete de partager le 
savoir du brillant docteur d'Oxford-. 

— Les programmeurs confirmes seront sans doute interesses par Jes 
paragraphes reperes par ce dernier sigie [informations techniques, 
langage machine,.) f 

A vous d'apprecier, ces symboles ne sont qu'indicatifs : nous vous 
souhaitons en tous cas une lecture agreable et de longues heures 
de passion en compagnie d'eve et de sa pomme ! 
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CHAPITRE 




Installation 



UinstallatJon de votre carte "Ove" est t.res facile, mais il est tres 
important qu'elle soil faite correctem&nt. Une mauvaise installation 
pourrait deteriorer votre Apple Itc. votrc carte "eve" et meme 
voire tefeviseur. 

Les explications sont illustrees de nombreuses photographies. 
Si i'instailatJon vous pose quelques prubiemes. n'hesite^ pas S 
demander conseil a votre dislribuleur Apple, 

Le materiei a votre disposition doit etre : 
— votre Apple Ho: 



Pholo 1 




ie petit materiel de fixation livr^ avec votre Apple fie (photo 1); 

en particulier une petite clef, deux vis a tete hexagonnle et unc 
plaque a visser pour connecteur 9 brocties. Si une de ces pieces 
vous manque contactez votre distnbuteur d ordinateurs Apple: 

votre carte -eve^' {LE CHAT MAUVE), 



les cables fournis avec la carte "eve>> (photo 2) destines au 
raccordemenl sur la prise Peritel de votrc televiseur; 



■ ■■•"".. -J ■■^''".'.Z^'k^ 
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Mais tout d'abord. W faut installer lo cable de sortie : 

— sur le panneau arriere de votre Apple lie, enlevez le cabochon 
de I'ouverture numero 5 en le poussant vers rBxterlGLff, Si celte 
ouverturc C5t deja occupee utilises Touverture numero B; 

— prenez le peMt cSble (chat mauve] et la plaque a vlsser (apple); 

— faites passer le connecteur plastique dans la plaque a visser 
(photo 3], attcntiun au sens, 



Photo 3 





— le petit fil (10 centimetres) pour le raccordemenl eventuel du son; 

— eventuellernent votre televiseur. 

Enlevor le couvercle de voire Apple He comme indique page 13 du 
guide de rutilisateur. 



L^ cSble Peritelevision NE DOIT PAS etro branche 
sur votie televiseur tant que la carle "eve» n'est pas 
complelement installee dans uotre Apple Ite- 



Verifitjz que votre Apple He est eleint (aucun voyant ne doit etre 

allume). 

A linl^rieur de votre Apple ;/e, vers larriere. vous voyez sept 

connecteurs numerotes (juste devant) 1 a 7. 

Devant le connecteur 3. vous trouvez un autre connecteur un peu 
plus grand a gauche duquel est marqoe AUX. CONNECTOR 
(connecteur auxiliaire}. 

La carte ^eve^' va se brancher a la fois sur le connecteur 3 et le 
connecteur auxiliaire, 




^ k 
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placez fe connecteur en forme de D ct la plaque a visser centre 
I'ouverture a i'interieLpr de lordinateur (photo 4), Alignez les 
encoches qui se trouvent en-dessus et en-dessous de Touvcrture 
du panneau arriere avec les trous des vis dans le connecteur 
et les ecrOLis sur Ja plaque a vpsser; 



I 




— Utplisez fes deux vis a tetes hexagonales pour fixer le connecteur 
yu panneau airiere. Visse^ avec la petite clef (photo 5); 



Photo 5 




E 






Regardez votre cartfi -eve-, cote composants. conneclours dores 
en bas. II y a sur la droite deux pelits connecteurs ; branches ie 
connecteur plastiquc sur celul du haul. Pas d'inqutetude : un seul 
branchement est possible (photo 6). 



Photo S 
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Ins^rez les connecteurs dores de la carte -eve", en meme temps. 
dans Ie connecteur 3 et Ie connecteur auxiHaire : placez la carte 
bien en face et enfoncez. Verifier voire installation (photo 7). 



Phulo 7 




Si vous desirez Ie raccordement du son a votre telSviseur, debranchez 
Ie connecteur du haut parlcur. marque J1S SPEAKER, a Tavant gauche 

de la plaque do votre Apple, et branchez a la place Ie petit fll fourni avec 
la carle >=eve". Branchez egalementce petit fil a I'avantde ia carte "eve- 
(p,hoto 8). 




ATTENTION : Seul Ie connecteur J1S SPEAKER 

sur la plaque electronique de votre Apple tie 
doit etre utilise En parliculier, NE PAS 
BRANCHER sur une eventuelle sortie "Son ■> 
similaire sur une carte peripherlque, avant de 
s'etre bien infornie. 



Photo 8 




Voire carte est mstallee. Relemez le couvercle de I'Apple //e Branchez 
mamtenanl la prise D (9 broches) du cablo perttel sur la prise que 
vQus venez d'installer a iamere de votre Applu lie (photo 9) Ne 
confoncfe? pas avec un autre connecteur. celui des poiqnees de Jeu 
par cxemple. 



Photo 9 





Branches la prise Pentelevisfon (grosse prise a I'Kutre bout du cabJe) 
au do5 de votre t^^leviseur. 



Allumez votre teieviseur. puis attendez q«jelques instants AllLfmez 
votre Apple /te: APPLE ]( doit apparaitre en haut de I'^cran, en blanc 
sur lond noir, Sinon eteignez immediatement votre Apple et verifiez 
V05 branchernents. 



Tcujours debrancher la prise Peritel^vision avant de 
toucher a la carte -eve-. Avanl d'ouvrlr le couvercle 
de f Apple, verifiez que I'Apple et le teJeviseur sont 
eteints. 




Essayez une nouvelle fofs, dventueilement reglez le bouton luminosite 

de votre televrseur. -nvaiva 

Si ie ..blanc=. de vos caracteres ne vous satisfait pas, essayez de reqier 
I equilJbro des couieurs en agissant avec un petit tournevis sur les trois 
potentiometre5 srtues k Tarriere de la carte '■ eve.. : ils reglent I'intensft^ 
des trois couieurs de base : rouge, vert, bleu (photo 10], Ce reqiaqe 
et celui de la luminosite sur votre toleviseur vous permettront d'obtenir 
la meijleure image possible. 



Photo 10 




Eventueilement, vous pouvez verrouiiler le connecteur du cable peritel 
sur le panneau arriere de voire Apple He en serrani avec un lournevis 

les VIS qui ss trouveni sur les cotes de ce connecteur 
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CHAPITRE III 




Le texte 






III-1 ^IMPLEMENTATION DE LA VISUALISATION 
DU TEXTE SUR L'Apple He 

|]h1.0 Introduction 

En visualisation texte, lafonction SOcolonnespermetd'afffChera i'ecran 
40 caracteres suppl^mentaires par ligne. 

L'Apple He standard affiche 24 lignes de 40 caracleres pour un plein 
ecran, la fonclion 80 colonnus perniet de doubler le nombre de 
caracleres par ligne. II est possible de passer facilement dc la 

visualisation 40 a 80 coionnes et victi-versa. 

Note : L'affichage sur un televiaeur standard pac la prise Pf RITEL 
ne permet pas une lecture tres satislaisanto des caract^res 
SO coionnes. Nous vou5 conseiHons dans ce cas I'utilisation 
dun moniteur monoctirome de bonne qualite. 



IM-1.1 Commutation du texte 80 coiont}es 

a) Sous Pascal et CP^M 

Au chargement du Pascal ou du CP/M, la commutation 60 coionnes 
est effectu^e automatiquement par le systems &i toutefois voire carte 
est correctement instaliee. 

En Pascal, H est possible d'utiliser les touchos tet -len execLitant au 
prealable le programme SETUP situe sur la disquette APPLE 3 
(se reporter au manuel 'APPLE PASCAL OPERATING SYSTEM 

REFERENCE MANUAL'}. 



Remarque : Pour eviter le passage automattque 

en BO coionnes vous pouvez utiliser la ^^recette^' 

suivante : 

— AJIumez votre Apple lie sans disquette dans 
les lecteurs. 
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— Enfoncez simuStan^ment I'es touches <Ctrl> et <rReset> 

puis relachez, le symbole J de I'Applesoft apparait alors en bas el k 
gauche de lecran, 

— Mettez vos disquettes dans les lecteurs. 

— Tapez I'instmction suivante 

POKE-16373,0:PR^6 

L& syst^me presenters un 6cran texte 40 colonnes comme si... (a carte 
eve n'existait pas. 

b) Sous Basic ou DOS 3.3 

A rallumage de votre Apple He, i'affichage est en 40 colonnes: pour 
obtenir un affichage 80 colonnes, il suffit de taper PR*3 (comme toute 
commande Basic, PR est obligatoirem&nt en lettres MAJUSCULES). 

Cette instruction ^tant executee. il suffit de taper : 

Esc 4 pour passer en 40 colonnes. 
Esc 8 pour retrouver les 80 colonnes. 

Esc designe ici la touche Esc et non pas la suite de lettres E, s. c, Une 
telle sequence : touche Esc puis autre(s) caractere(s) est appelee 
sequence d'^vasion. 

II en exisle de nombreuses; reportez-vous au paragraphe in-1.2 pour 
pfus de details, 

II peut vous etre agreable d'obtenir 80 colonnes des I'aliumage de voire 
Apple He sous DOS 3,3; il vous suffit de modifier le programme 
d fnitialisation en y incorporant les deux instructions suivantes : 

1 D$=CHRS(4) 

2 PRINT D$: «PR#3» 

IM-1.2 Modes de visuaiisalion sous Basic ei DOS 3.3 

Cos modes sent etroifement lies a I'activation do la FONCTJON 
SO colonnes. Lorsque cette fonction est activee, deux modes de 
visualisation sont possibles en texte : 24 lignes de 40 caracteres ou 
bien 24 lignes de 80 caracteres et dans ces deux cas le curseur 
est un rectangle blanc, Si la fonction 80 colonnes nest pas activee, un 
seul mode de visualisation texte est possible : 34 lignes de40caracteres- 
Le curseur est alors un damier clignotant. 

Comme noL^s Tavons deja vu, I'activation de cette fonction est realisee 

par TinstruGtion Basic PR#3. 

La desactivation quant a olle peut s'operer de deux fagons diff^rentes ; 

— soit par la sequence d'evasion Esc Ctri-Q 

Le Curseur en forme de damier clignotant apparait en bas de I'ecran 
surmonte dun caractere « backslash » sur la ligne du dessus. Vous 
etes de nouveau en 24 Ngnes de 40 caracteres et tout programme 
BASIC en memoire au moment de la desactivation est conserve 
intact 



n 

!j 
!j 

3 



!j 

1!^ 




25 



b 



— soit par la commande Ctrl-Reset 

Vous retrouvez le curseur a damier mais vos lignes de texte sont 
devenues incomprehensibles. Un programme Basic en memoire 
peut alors 5tre irr6mediabiement endommage. II convient done 
de le sauver avsnt d'utiliser cette commande. 
Si toutefois vous ne I'avez pas fait, ne repandez pas Inutllement vos 
larmes et tapez LIST a tout hasard: vous avez malgre tout de 
grandes chances de le recuperer, 

a) Aspect commun a tous les modes texte 

Toutes les commandes Basic fonctlonnent egalement dans tous les 
modes a I'exception de celles alfectant la labulatron horizontale, I'aspect 
du curseur, celui des caracteres et bien entendu le passage 
40/80 colonnes et vice-versa. 

b) Visualisation fonction non activee 

vous disposez de tous les caracteres minuscules et majuscules du 

clavier en 24 lignes de 40 caracteres, 

Lorsque la touche ALPHA LOCK est enfoncee, vousobtenez I'ancienne 

visualisation Apple II et Apple II Plus et de ce fait une totale 

compatibilite avec les logiciels ecrits pour ces machines Les modes 

speciaux obtenus par les commandes Basic FLASH (caractere 

clignotant) et INVERSE (caractere noir sur fond blanc) fonctionnent 

parfaitement dans ce mode mais n'affectent pas les caracteres 

minuscules. 

Vous avez egalement acces a toutes ies sequences d'evasion hormis 

celles ayant trait a la fonction 80 colonnes (Voir Tableau 1), 

c) Visualisation fonction activee 

c,1 La tabulation horizontale en 80 colonnes 

Dans tous les cas, I'instruction BASIC HTAB peut etre suivie d"un 
nombre entre 1 et 255; si ce nombre est inf^heur ou i^gai a 40. pas de 
probleme : le PRINT suivant impnmera le mot a cette tabulation. Par 
centre, si la valeur suivant HTAB est superieare a 40. i'expression 
s'affichera alors sur les lignes suivantes, 

Ceci pose un probleme en 80 colonnes : pour y remedier, vous pouvez 
remplacer HTAB N par POKE 36, N si N est superieur ^ 40. Votre 
expression s'affichera alors ou vous le souhaitez. 

Essayez done le programme suivant : 

10 HTAB 55 : PRINT "TABULATION H=55" 

20 POKE 36,55 : PRINT "TABULATION EXACTE« 

Tapez RUN et voyez par vous-meme ce qu'il advient I 

De meme la tabulation norizontale obtenue par des virgules entre les 
expressions a imprimer ne fonctionne pas correctement en 80 colonnes. 



Tspez Esc 4 puis e^ecutez ce programme : 

10 PRINT «POMME", -^ CHAT -, -CHAPEAU" 

Tapez RUN puis Esc 8 puis de nouveau RUN 

Tenez compte du resultat pour vo5 prochains programmes... 

C.2 Les instructions FLASH, INVERSE et NORMAL 

Lor&que la function 80 colonnes est actives, la commands INVERSE 
affecte aussi les caracleres minuscufes tandis que la commande FLASH 
n'a aucun effet. 

Toutefojs, m^fiez-vous. il ne fsut pas etre en mode FLASH lorsque 
VOU5 tapez PR-3 pour acliver la fonction 80 colonnes; vous travaillerez 
alors en noir sur fond blanc et toute une partie de voire texte apres 
LIST ou un RUN serait incomprehonsible. 

Pour annuler les commandes FLASH et INVERSE, tapez NORMAL. 
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C-3, Le rnode majuscufe restreint 

Ce mode vous interdit les lettres minuscules a I'exception de celles 
contenues dans des guidemets si bien entendu la touche ALPHA LOCK 
n'est pas enfoncee. Dans le cas contraire, les lettres entre guillemels 
seront aussi des majuscules. On entre dans ce mode en tapant la 
sequence Esc R; on en sort par Esc T, 



Essayez : — Tapez Esc R 

— Relevez la touche ALPHA LOCK si elle etait enfoncee 

— Tapez print «j'ai compris" 

Avez vous comprJs ? 

— Tapez Esc T et recommencez : cette fois, le mot print 
reete en minuscuies et le SYNTAX ERROR? bien connu 

a pp a rait. 

Voici un mode bien pratique ! 

C.4 Comportement du curseur en mode d'evasion 

Des que vous frappez la touche Esc, le curseur clnange d'aspect : 
c'est toujours un rectangle blanc mais a present II contlent ijn signe | , 
II restera ainsi jusqu'a ce que vous ayez termine votre sequence 
d'evasion. 

Lorsque vous tapez Esc puis les touches ; t ^et -t- fe curseur sed^place 
dans le sens des ffeches sur I'ecran. En particulien les caracteres sur 
lesquels II passe ne sont ni recopies ni ettaC'^s de la m^moire. 

Pour terminer votre sequence et rcventf au mode normal, frappez 
srmplement la barre d'espacemenl; le curseur redeviendra uniforme. 

Pour plus d'information sur les sequences d'evasion, voir fe tableau lll.l, 

C.5 Restriction en affichage 80 colonnes 

Lorsque votre ecran affiche SO caracteres par (igne, NE TAPEZ PAS 
PR#6 pour relancer le systems. Repassez auparavant en 40 colonnes 
par Esc 4; tout se passers normalement et votre ^^cran restera 
comprehensible. 

De m§me, si vous voulez sortir du systeme Pascal pour revenir au 
DOS 3,3 : une procedure courante est d'inserer une disquette sous DOS 
et de taper H]alS au niveau le plus tiaut de commande. Ctiangez 
d'habitudes, inserez votre disquette sous DOS et tapez Ctrl-Reset pour 
les raisons indiquees ci-dessus 

C.6 Passage 80/40 colonnes et vice-versa par programme 
A cet effet deux caracteres de controle sont indispensables : 

— le caract^re Ctrl-R {Code ASCII decimal 18) passe en affichage 
80 colonnes; 

— le caractere Ctrl-Q (Code ASCN decimal 17) vous fail revenir en 
40 colonnes. 

Essayez done ce pellt programme : 

10 PRINT -' JE TREMBLE DE TOUS MES MEMBRES ■> 
20 PRINT CHRS(17):PRINT CHR$[18) 
30 GOTO 20 
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Tapez RUM puis Ctrl-C lorsque ce tremblemeni aura quitl^ r^cran 

Pour plus d'information sur les caracteres de contr6ie, voir le 
tableau III. 2. 



III-2 TEXTE COULEUR EN BASIC 
SANS LOGICIEL SP^CIFIQUE 



En Basic, si vous ne desirez pas charger le logiciel Basic PURPLESOFT 
et mafgre tout utiiiser les possibilit^sde voire carte <> eve "&n modetexte 
nous vous donnons ci-dessous ie moyen de ie faire. Notez lout d'abord 
que ce fogiciel n'occupe qu'environ 1K de ia memoirs de I'Apple lie et 
qu'il est done tout a fait discutable de refuser ia souplesse d\itilisalion 
qu'il vous procure. 

Vous pouvez rempiacer la visualisation monochrome bianche des 
textes 40 et 80 colonnes par une visualisation monochrome verte en 
tapant rinstruclion : 
POKE-16197,0 

Pour revenir a fa visualisation blanche tapez : 
P0KE-I6l98,a 
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A chaque fois que vous changer les valeurs de C ou F, ex^cuter k 
nouveau I'inslruclion POKE -16199,16*F+C 

Remarque ; Tout -scrolling" de J'ecran provoquera I'atfichage de tous 
les caracteres dans fes couleurs C et F. 

Pour quitter le mode texte couleur executer : 
POKE-16200,16*F+C 



5-HS 




Vous pouvez, en tej^te 40 colonnes, choisir parmi 16 la couleur de 
chtjque caractere et la couieur du fond. Placer les couleurs souhaitees 
dans deux variables, par exemple C (caracteres) et F (fond) par leur 
numero d'ordre ; 



noir 

magenta 
bJeu fqnce 
violet 
vert fonce 
gris 1 

6 bleu 

7 bleu Clair 



6 


marron 


9 


orange 


10 


gris 2 


11 


rose 


12 


vert 


13 


jaune 


14 


bleu turquoise 


15 


Plane 






Pour passer en mode texte couieur il suffira d'executer : 

POKE-16199,16*F+C 

A partir de cet instant tous les caracteres envoyes a I'ecran apparaitront 
en couleur C sur couleur F. 

ATTENTION : Tous les caracteres deja sur I'ecran a cet instant 
apparai'tront dans des couleurs indeterminees. Au premier acc^s 
k ce mode texte couleur, executer I'lnstruclion HOME, tout I'ecran 
se couvrira d'un fond de couleur F. 
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Sequences d'evasion 



Code 



Fonction 



Notes 



ESC S : Efface la fen^tre et remonte Je curscur en 0,0 

ESC A Deplace le curseur d'un caractere vers la droits 

ESC B : Deplace le curseur dun caractere vers la gauche 

ESC C : Descend le curseur d'une ligne 

ESC D : Remonte le curseur d'une ligne 

ESC E : Efface fa fin de la ligne 

ESC F : Efface le baa de la fenetre 

ESC I ; Remonte le curseur d'une ligne 

ESC ^ : Remonte le curseur d'une Jigne 

ESC J Deplace le curseur d'un caractere vers ia gauche 

ESC - : Deptaco Je curseur d'un caractere vers la gauche 

ESC K : Deplace le curseur d'un caractere vers la droite 

ESC ^ : Deplace le curseur d'un caractere vers la droite 

ESC M : Descend le curseur d'une ligne , 

ESC t : Descend le curseur dune ligne ...,.,.. 

ESC R ; Entre dans le mode majuscule restraint 2 

ESC T : Quittc fe mode majuscule restrefnl 2 

ESC 4 : Commutation en 40 colonnes {ecran efface, 

curseur remonte) 2 

ESC S : Commutation en 80 colonnes (ecran efface. 

curseur remonte) 2 

ESC CONTROL-Q : Desactivation de la fonctfon BO coionnes ... 2 



Notes 



1 : L ecran resle en mode cf'^vasion sans avoir k refrapper ESC 

2 : Uniquement lorsque la fonction 80 colonnes est activee. 



Tableau 1 1 1-1 



?A 



Caract^res de contrdle 



Caractere Code ASCII 



Fonctfon 



Notes 



CTRL-G 
CTRL-H 
CTRL-J 

CTRL-K 

CTRL-L 

CTRL-M 

CTRL-N 

CTRL-0 

CTRL-Q 

CTRL-R 

CTRL-S 

CTRL-U 

CTRL-V 

CTRL-W 

CTRL-V 

CTRL-Z 

CTRL-p 

CTRL-§ 



10 

n 

12 

13 

14 
15 
17 
18 
19 
21 
22 
23 
25 
26 
28 
29 



L'Apple //e produil un -bip" sonore 
Deplace le curseur dun fsspace vers la gauche 
Descend le curseur d'une ligne 

Efface le bas de la fenetre 1 

Remonte le curseur et efface la fenetre . . 1 
Curseur au debut de (a ligne sulvante 
Caracteres normaux [bianc sur noirj ... 1,2 

Caracteres inverses (noir sur blanc) T.2 

Commutation en ecran 40 colonnes ... 1,2 

Commutation en ecran 80 colonnes 1,2 

Arr§t de renvoi des caracteres a I'ecran . 1,3 
Desactivation de la fonction 80 colonnes 1.2 
L'ecran descend d'une Ngne ............ 

L ecran remonte d'une ligne 

Remonte le curseur en 0,0 {sans effacer) 

Efface la ligne du curseur , 

Deplace fe curseur d'un rang vers la droite 
Efface ia fin de la ligne du curseur l 



Notes : 

1 
2 
3 



La fonction 80 cofonnes doit etre activee 
Ne fonctionne que d'un programme 
Ne fonctionne que du clavier 



Tableau 



K^ 
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Le graphisme 




L. 



CHAPITRE IV 




Le graphisme 



IV-1 LES DIFFERENTS ECRANS GRAPHIQUES 

Un dessin sur lecran de ra(re televiseur on de votre monileur n'est en 
fait qu'une juxlaposilion de petites surfaces elementaires : les cases 

d'une grille... Et vofre dessin sera d'autant plus fin que le maidage 
cfe la grille est resscrre. 

Pour reperer une cfe ces cases de cette griHe, on donnera sa positron 
horizontale et sa position verticale; I'origine des positions devra 
egalement etre connue (fig IVJ). 




1 

2 
3 

4 
5 

6 

7 
8 

Figure IV-1 



Case rouge en (2,S) avec une ongine (0.0) en bas et a gauche dc la grille. 
Case verte en (2.8) avec une origine (0,0) en haut et a gauche de la grilte. 
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On peut caracteriser une grille par le nombre des positrons horiZDntales 
et verlicaiGs quelle possede. 

Plus ces nombres sont eJoves, pl'us ies dimensions d^une case sont 
reduiles plus la finesse du dessin est grande : en effel si le maillaqe 
de la gnlle vane, le moniteur ou le poste de television garde des 
dimensions fixes : vous ne Tavez jamais vu gonfler ni retrecir !! 

Ainsi nous pourrons attribuer a un ecran graphique une definition 
norizontale : nombre de positions ou cfe cases le long dune m^me 

nonzontaJe (egalement nombre de colonnes) 

De la meme maniere nous parlerons de definition verticale ■ nombre 
de positions ou de cases le long dune m^me verticale (eqalement 
nombre de (ignes) 

Un tres grand nombre de lignes et de colonnes est bien entenrfu le 
meilteuf garant de la precision d'un graphisme; ce n'est copendant 
pas une regie absolue : en effet il exists un nombre de cases au^dela 
duquel le gain de precision est lilusoirecar les appareils de visualisation 
sont limites dans leur faculte de reproduire un objet tres peJit Telle 
est la driference fondamentafe entre moniteur haute-resoiution el un 
eleviseur cJassique, Le leleviseur arrive en Irmile de resolution pour 
la grille la plus resserree que peuvent generer I'Apple lie et la carte 
-eve- :ceslen particulicr le cas pour une definition hori^ontaJe de 
bbu points. Un moniteur haute resolution peut aller plus loin si 
toutefois il merits son appellation I 

Mais revenons a ce qui en definitive vous interesse le plus ■ de quels 
ecrans graphiques disposez-vous done sur Apple tie ? 



iV-1.1 Bcfan standard Appie He 

C'es! une grille de 280 colonnes sur 192 lignes dont lorigine est situee 
PasJIl ^ ^^ ^" ^^^^ (pornt(0,0)) et en bas et a gauche en 



IV-1.2 Ecrans =eve" 

II en existe trors qui ont (ous leur origine en bas el a gauche de I'ecran 
quel que soit le langage employe : 

— Gnlie 280x192 

— Grille T40x192 

— Grille 560xt92 

Motons au passage que toutes ces grilies ont une definition verlicafe 

de 192 hgnes tandis que ia definition honzontale varie du simple au 

nH?I^Ti'n^■no'"'^' ""l^ '^^^'^ ^^^^ ^^' ^'^^^'■s fo's plus large dans une 
grille 140x192 que dans une grille 560x192. 
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rV-2 PROBLEME DE COLORIAGE D'UNE CASE 

Dun poinl de vue informatique colorfer une case revient a coder sa 
couleur et sa position. Dans fe cas des 16 couleurs usuelles Apple, nous 
avons besoin de 4 bits pour en coder la totafite, fa position de la case 
etant fournie par un calcLiI d'adresse. 

Le systems Appie exige SK de merrioire pour une image en 2 couleurs 
coloriee case par case, 16K pour 4 couleurs et if exigerait 32K en 
16 couleurs pour une grilie de 280x192, 

Etant donne que I'ecran standard Apple He vous offre deja 6 couleurs 
pour 8K de m^molre, cela signifie done que les couleurs ne sont pas 
disponibles case par case et qu'il y a "une astuce" I 

Nous vous presenlons c(-deasous les trois colorfages utilises par 
J'Apple He et eve. 



IV-2.1 Coloriage standard APPLE He 

L'Apple utilise pour son graphisnie une zone memoire commenqant 
a ladresse B1 92 et finissant en 18383 appel^e page haute-resolution n" 1 . 

Ghaque serie de 7 points sur une meme ligne de I'ecran correspond 
a un octet de cette zone memoire. Un point est allume forsque le bit 
correspondant est a 1. Une ligne est done form^e de 40 series 
de 7 potnts. 

AJnsf 165 40 premiers octets de ia page HR rT^I (8192-16383) contiennent 
les intormations de la ligne situee en haul de I'ecran. 

Le bit de poids fort de cheque octet (bit n" 7) nest pas visualise mais if 
condltionne en partie la couleur des 7 points lies a I'octet dont il fait 
partie. 

Ainsi, si le bit 7 est k 0, tout point isole correspondant a cet octet et situe 
en colonne paire apparaft violet, en colonne impairs apparait vert. 

Si le bit 7 est a 1, ies points isoles en colonne paire apparaissent bleus, 
ceux en colonne impaire apparaissent rouges. 

Si deux points ou plus sont cate a cote sur une meme ligne. ils 
apparaissent blancs meme sUs ne dependent pas du meme octet. 

Pour mieux comprendre, tapez en Basic APPLESOFT le programme 
suivant : 

10 HGR 

20 HCOLOR=3 

30 HPLOT 21,0 TO 122,0 TO 122.150 TO 21 15G TO 21 

70 END 

puis RUN 
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La ligne 20 met ia couleur au blanc pour les instructions de dessin qui 
suivent; ie resuitat n'est pas tout a fait celui escompte; a vous de 
i'expiiquer en sachant que dans ce cas (HCOLOR=3). le bit 7 de ctiaque 
octet est a 

Tapez a present HCOLOR— 7 {autre valeur de HCOLOR pour le blanc) 
puis RUfM 30. 

Autre resultal i a voire, avis pourquoi ? 

Si vous desirez de plus amples precisions sur ce •' mysterJeuJt 
comportement ', reportez-vous au manuel de reference de I'Apple He. 




mode HRAPPLE II 

IV-2.2 Coloriage par serie de sept points foreground-background 

Comme dans le coloriage standard, les points sont rcgroupes 7 par 7 
et chaque groupe dc 7 points correspond a un octet (bits a 6) de la 
page haLjte resolution n 1, 

Tout point allume (bit i\ 1) sera de la coiileur de ^^ premier plan '^ 
[foreground), toLit point eteint (bit a 0) sera de la couleur 
d'«arriere-plan- (background). 

La definition de ces deux couleurs exige un octet de memoire 
supplementaire pour chaque serie de sept poinis : il est fourni par ia 
memoire auxiliaire de voire carte eve. 



w 



40 



Ainsi a une meme adresse, I'octet en memoire principaJe determinera 
sf fes sept points qui luf correspondent sont allumes ou non ; en memoire 
auxiliaire le demi-octet de poids fort donnera fa couleur d'arhere-plan 
(16 possibiiites), le demi-octet de poids faible la couleur de premier plan 
(egalement 16 possibiJites). 

Voici un exemple qui facilitera voire comprehension : 



Figure 
IV-2 



Ecran couleur 



^T 



^ 



110 10 1 



Memoire principale 



10 
poids fort 



11 
poids faible 



Memoire auxillsire 



0100 binaire := 4 decimal -♦ couleur vert fonce 
0011 binatre — 3 (decimal ^ couleurviolet 



Nous pr^cisons que pour chaque octet de la memoire principale le 
point le plus a gauche correspond au bit de poids faibJe de cet octet. 

lV-2.3 Coloriage point par point 

Avec 16 couleurs disponibles, ce type de coforiage necessite un 
demi-octet par point : W est done bion plus gourmand en memoire; 
aussi les modes graphiques lutilisant cfevront diminuer soit le nombre 
de couleurs disponibfes, soi^t Ja definition Inorizontale sfin que 
I'occupation dune page graphique reslc compatible avec les 
possibilit^s de votre Apple //e associe k la carte eve. 

li n'existe dans ce cas aucune Jimitation a I'exjstence d\ine couleur 
oij que ce soit dans la grille et Ja programmation s'en trouve d'autant 
plus facilitee. 

IV-2, 4 A\/antages et inconvenient^ des differents types de coioriage 

De loute evidence, le coioriage poir>t par pornt est appele A devenir le 
standard en la matiere. Sa faciJite d'emploi, son absence de surprises (!) 
le determine en ce sens. Toutefois sa gourmandise en memoire no 
permettait pas jusqu'a present de rutilisersurtous les types de machine. 
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Le coioriage standard Apple Ug a pour iui I'indfacLitable avantage de la 
compatibilite avec I'ancien Apple Jl et TApple II Plus et done avec tous 
les programmes graphiques ecrrts pour ces machines, 
II exige une gestion plus rtgoLrreu^c de I'espace memoire et rend la 

progran-imation plus delicate. Testez-Ie en detail grace au programme 
du paragraphe lV-2.1 en faisant progresser HCOLOR de 1 a 7. Ce que 
vous verrez vous en apprendra plus que toute information ecrite. 

Enfin, le rccouvrement couleur '= foreground-background" est un 
moyenlermeentrele point par point et le standard Apple. Bien employe, 
il permet de creer yne image -'loLiilleG- en 16 couleurs avec une 
resolution idenlique au mode standard. 



fV-3 MODES GRAPHIQUES 

Un mode graptiique est defini par son nombre de colonnes et son 
nombre de lignes ainsi que par le type de coioriage qu'il emploie. 

L'occupation memoiro dune page graphique varie en fonction du mode 
choisi; les modes -^'Sve'^ occuperit 16K"0ctets tandts que ie mode 
standard Apple /te se contente de 8K-octets. 



IV-3.1 A7ode standard Apple He 

Cette appellation recouvre en fait differents mode qui se dlsllnguent 
par feur type de coioriage el leur interpretation par la carte eve , 

—Mode HRAPPLEII: ecran 280x192 et coioriage standard 

Apple I!g. 

meme ecran, coioriage standard Apple 

avec cette difference : les points isoies de 

couleur sur un fond Plane apparaissent 

noirs, 
—Mode HRSPEC2: identique S HR5PEC1 mais en plus les 

points isoies sur fond noir apparaissenl 

blancs. 
—Mode HRDASH: les lignes horizontales de couJeur violelle, 

verte, rouge ou bicue apparaissent 

pointillees, 

ecran 280x192 en noir et blanc. 



—Mode HRSPEC1: 



—Mode HRBW: 



HRSPEG1 el HRSPEC2 senyent a obtenir une meilieure Ijsibilite des 
caracteres graphiques; HRSPEC1 affecte tres peu le rests de Timage 
tandis que HRSPEC2 fa blanchrt. 

Tous ces modes sont des derives du mode standard Apple lie et 
occupent au total 8K-octets de memoire; nous los appelons aussi 
" modes 8K». 
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IV-3.2 Modes eve 

— COLt40: ecran 140x192; coloriage en 16 couleurs 

point par point. 
— COL280A: ecran 280x192: coloriage point par point 

en 4 Couleurs (noir. orange, ve»1, blanc). 
— COL280iB: ucran 280x192; coloriage point par point 

en 4. couleurs [noir. bleu-clair, rose, jaune). 
— CP2B0: ecran 2BUx^92; coloriags -foreground- 

bacl^ground >■ en 16 coL;Jeijrs par scries de 

7 points horr^ontaux. 
— BW560: ocran S60x192; coloriage noir et blanc. 

L'avanlago de ces differents modes est d bffrir soit plus de couleurs, 5oit 

une meilJeure resolution. LincoRvenient est qu'ils otcupent deux fojs 
plus de memoire : SK-octeta en mcmoire pnnclpale e! BK-octets en 

memoire auxiliairc : ce sont des ;= modes t6K". 
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mode COL140 



=! 



nnode COLI-lCi 



b 




rrccie COL140 
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mode BWseo 
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mode Col Ml! 
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mode COL 140 



IV-4 LE CURSEUR GRAPHlQUE 

Tout Gomme en texte, la page graphique dispose de son curseur: 

Ig dtfference est qu'if n'apparfiTI pas sur I'ecran, maig sa position est 
pr^sente en niomoire Ce curseur peut etrc deplace en laissant trace 
de son passage ou non de lagon absolue ou relative vous pouvez 
en fail Ic considerer comme la poinie d'un crayon se deplatpani sur une 
ffeuilfe cfe papier (voire ecran). On associera au crayon une-'coufeur 
de crayon '^ et au papier une "couleur de pap(er:>. 

Plusieurs instructions permeltent de gerer le deplacement de 

ce curseur. 



IV-5 LES POrNTS ET LES LIGNES 

On peut tracer un point soit a Tend ro ft ou se trouve le curseur graphique, 
soft a un endroit repere par ses deux coordonnees d ecran X et Y. 

Tracer une ligne peut etre equivalent A tracer un certain nombre de 

points, mars il est possible de te faire djrectement. 
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La connaissance du point de depart el du poinl d'arrivee de la ligne 
suffil alors a la definir On peutenvisagersynthetrquemenl ce trace sous 
deux angles differents , 

— Irace dun point (X1. Y1) a un autre point (X2, Y2). 

— trace de la position du curseur a un point d'arrivee de coordonnees 
inconnues en deplagant le curseur de DX colonnes ot de DY hgnes. 



IV-6 LES COULEURS 

Nous dfsposons au total de 16 couleurs differentes 



k 



rnrmm ' 




■■ ti m^rron 


mi 1 fli^ CI ^ n'^ .4 


^H 9 Orange 




■i ld:<ris 2 


■■1 3:moUt 


^m li:]Ro5e 


I^H 4:'0«rt -fonctf 


^H 12 t>prt 


1^ 5:^ril? 1 


^H 13:c^une 


■i 6'.Blmt 


■■ 14rCur^uoise 


IPB 7'Bl^u Clair 


^B 15 Blanc 
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mode CP2eQ 

et d'une '■couEeur transparente". 

A tout moment, Jors des operations de (ravage et de remplissage. deux 
couicurs sent selectionnees parnil les dix-sepl specifities : 

— ta coLiieur dc tragage (encie] 

— ia couleur de remplissage (papier) 

Par defaut, la couleur de trag:age est au Plane, el celle de romplisscige 
au noir. 

La fagon la plus simple de dessiner est de tracer un point a i ecran d'ans 
Fa couleur do tragage, sans se preoccuper ni de la coufeur. ni de fa 



LT 
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locailsation du point anterieLrreinenl affiche. Ceci a i'interet de foumir 
une plus grande vftesse d'execution. mais pose le problems de la 
protection de certaines parties de I'ecran (protection locale) et de 
certaines coulcurs [protection des couleurs). A ce dernter probleme. 
deux tectiniques simples apportent une solution partielle ; 



IV-6.1 Protection dos couleurs 

lino table de commande des couleurs peut etre eventuellement utiNsee 
dans toutes les operations tie tragage et de remplissage. La couleur du 
point trace depend alors de la couleur du point proexistante et de celle 
qui vient se supcrposer dessus Par defaut, la table de cornmande des 
couleurs n'est pas utilises : le poin! trace "Sort" alors de la couleur de 
tragage predetermines (ou de remplissage, selon I'operation effectuee], 

Supposons que vous dessinicz des arbres en employant les couleurs 

d'encro vert, vert-clair et marron; vous ailez constituer au bout d'un 

temps plus ou moins fong une foret touffue. 

Vous avez commence voire dessin avec un fond bleu-clair et vousvoufez 

a present rajouter un chateau blanc dernere la foret et devant le ciel, 

II suffira de poaitionner ainsf la table des couleurs ■ 

BLANC sur VERT donne VERT 

BLANC sur VERT-CLAIR donne VERT-CLAIH 

BLANC sur MARRON donne MARRON 

BLANC sur BLEU-CLAIR donne BLANC 

A I'initiaJfsation, la table des couleurs renvois toujours un resultal lei 
que : couleur d'encre sur couleur d^^cran donne couleur d'encre. 
De meme, la table des couleurs n'est pas toujours activee : a vous dc le 
fairo en sachant qu'un trace est plus lent lorsqu'il tient compte de cette 
table. Par defaul la table de commande des couleurs est fnactive. 



IV-6.2 Operations logiques bit a bit 

L'option de transfert est un oLitil un peu plus complfque et qui peut 
donner des resultats elonnants pour qui i'emploie sans la maftnser. 

Cette option permct de faire une operatran logiqiie bit a bit entre la 
couleur dencre et celfe de lecran. 

Les differentes operations logiques sont : 

— «ou inclusif" : encre ou ecran 

— "OU exclusif" : encre ou bion ecran (operation tres utjie car elle 
perrnet du tracer une premiere fois sur un fond complexe et de reobtenir 
le fond en tragant une deuxieme fois} 

— " et ■■ : encre et ecran 

— non encre (negatif) 

— non encre ou ecran 

— non encro ou bign ecran 

— non encre et 6cran 
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Par defaut le transferr affichc la couleur encre quelle que soit la couleur 

^cran 

!l est a noler qui; lorsque la table de commande cfes couleurs est 

active, encre d^signe icf ki couleur retournee par cgIIg-cl 

La couleur affichee est d^ternriinee ainsi : 

COULEUR D'E^JCRE -^ TABLE DES COULEURS - OPTION 
DETRANSFERT ■ COULEUR AFFICHEE 



IV-7 LA FENETRE 

De meme qu'il peut etre utile de proteger uno couleur. il est parfois 
indispensable de soustraire toute une zone de recran a ries traces 
eventuGls. 

A cet ettet vous disposez d'une fenetre, elle peut etre imaginec com me 
un rectangle fictif a I'lnterieiir dirquel unt lieu toutes les operations de 
tragage eJ dc remplissage. Par exemple, si on Irace une ligne en travers 
de f'ecran, seule la porlion de la ligne situee a linterieur de la fenetre 
sera visualises; le reste de I'ecran no sera pas affecte par le trace : il so 
trouve done ainsi protege. 

N.B. : — La position courante du curseur n'est pas FimJte a I'lnterieur 
fenetre; en fait, Tatiscisse ou lordonnee du curseur peuvent 
merrm prendre de& valeurs negatives. 

Par defaut, ce rectangle est lecran grapfiique tout entier dans leqirei 

vous dessinez. Bien entendu. vous pouvez modifier les diniynsions 
de la fenetre. Tout trace a I'exlerieur de cctte fenetre n'apparait pas 
sur I'ecran. 



IV-8 LES FORMES 

On peut afficher a I'ecran ^ la position du curseur de petits dessins 
en deux couleurs Ces petits dessins doiveni etro crees en memoire 
sous la forme dun tableau rectangulaire de bits Les seront afliches 
dans Ja couleur de remplissage et les 1 dans la couleur de tragage 
(eventuellement modifiees par la table de commande des couleurs et 
Toption de transfert). La hautour et/ou la largeur de ces dossins sur 
I'ecran pout etre multipliee par 1, 2, 3... 



IV-9 LES CARACTERES GRAPHIQUES 

II est possible d'afficher sur Tecran graphique des caracteres et des 
cfiaines de caracteres de couleur a la position du curseur Huit 

ensembles de caracteres sont diEponihIes en permanence. 11 est m§me 
possible de remplacer un ou plusieurs d'entre eux en cours de 
programme. La hauteur et/ou la largeur de ces caracteres sur I'ecran 
peut etre multipliee par 1. 2, 3 .. 
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CHAPITRE V 




Le logiciel 
Basic Purpfesoft 



V-1 QUE VOUS OFFRE CE LOGICIEL ? 

PoLfr une occupation inmime de la memoirG principale (1K), 
PURPLESOFT gere la totallto dos modes de visualisation, texts et 
graphlqLie. spGoillqufis a la carte eve. 

En pins de ces imodes, PURPLESOFT vous permet de travarller 
conjointement avec Ig3 anciennes instructions texte et graphpquu 
Applesoft moyennant queiques precautions. 



V-2 MISE EN CEUVRE DE PURPLESOFT 

Ce logiciel utilise ta foncition & (Anipfirsand) du Basic Applesoft qui 
permet detcndre lensemble des instructions de ce langage. Toutes les 
nouvelles Instructions commenceront put ce synbole &. 

Toutes les routines necessaires a ces nouvelles instructions scront 
chargec5 un memoire par le programme HELLO prcsenl sur la disquette 
PURPLESOFT. 

Ceci sera lait automatiquement si vous allumez votre Appk; He ou si 
VOUS elfectLiez un <Ctrl-pomme ouvertc-Rcset > avec PURPLESOFT 
comme disquette d'amorgage. 

Note : II est conseille de dupliquer cette disquette avanl lOLtte utilisation 

el de garder I'original en lieu siir. (ConSLilter a ce propos le manual 
du DOS). 



IMPORTANT : Pour bien comprendre lesexplicatians qui suivent, il est 
necessaire de lire au prealable les chapitres Jll et IV. 
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V-3 COMMUTATION DES DIFFERENTS MODES TEXTE 

Cette commutation s'effectue par I'rnstruction &TEXT n ou n est un 

param^tre variant de a 6, 

Les caracteres seront imprimes par Tordre PRINT habituel du Basic 

Applesoft 



&TEXT 1 

&TEXT 2 
&TEXT 3 



Ecran de 24 Jignes de 40 caracteres noir et blanc; curseur 
damier L'ecran est mis au noir et le curseur en haut k 
gauche. 

Identique a &TEXT 1. Curseur bfoc, 

Ecran de 24 lignes de 40 caracteres couleur; curseur damier 
L'ecran est remplf de ra couJeur fixes par SBACK— Curseur 
en haut et a gauche. Les caracteres seror^t imprimes dans 
la couleur fixee par &C0LOR sur un fond fixe par 
SlBACK- . ^ 



&TEXT 4 
STEXT 6 



&TEXT 6 



&TEXT 



Texte couleur (identique a 5=TEXT 3). Curseur bloc. 

Ecran de 24 lignes de 80 caracteres noir et blanc Tecran 
est mis au noir et le curseur en haut a gauche. 

Ecran de 24 lignes de 30 caracteres noir et vert, l'ecran est 
mis au noir et le curseur er> haut a gauche. 

Retour au dernier mode texte utilise sans effacement de 
l'ecran et sans positionnement du curseur. Cette instruction 
est con^;;ue pour revenir d'un mode graphique vers un mode 
texte sans effacer l'ecran texte; elle NE DOIT PAS etre 
utihsee apres un <CtrhResel> , il faut alors repreciser le 
mode texte dans fequel on desire travailler. 

IMPORTANT : Pour le bon fonctionnement de fa visualisation fiTEXTO 
doa etre utilise a la pface de linstruction Applesoft : TEXT, 

Le programme DEMO TEXTE sur la disquette PURPLESOFT vous 
donne un exempJe d'utiJisation de cette instruction Execulez le 
par RUN DEMO TEXTE puis listez-le par LIST. 



V-4 COMMUTATION DES DJFF^RENTS 
MODES GRAPHIOUES 

Cette commutation s'effectue par I'inatructlon &GR n ou n est un 
parametre variant de a 10. 

&GR 1 Mode HRAPPLEI/ {mode standard Apple He) 
&GR2 Mode HRSPEC1 






i 
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&GR3 
&GR4 



Mode HRSPEC2 
Mode HRDASH 



&GR 5 Mode HRBW 

Tous fes modes ci-dessu3 sont des modes SK. I'ecran n'est pas e(fac6. 
Seules les instructions Applesoft de la haute resoiution y operent : 
HPLOT. HCOLOR. DRAW, XDRAW, elC- L'instruction Applesoft HGR 

permet alors d'effacer I'ecran au noir. 

ir\/lPORTAIMT 1 L'instruction HGR du Basic Appfesoft DOIT etre 
imperativement precedes d'une instruction du type SGR n {n entre 1 
et 5) correspondant a Tun des modes precedents. Parexemple effectuer 
un SGRI pour obtenir la haute resolution Apple He putseventueitement 
un HGR pour effacer lecran. 

&GR 6 Mode COL140 

&GR 7 Mode COL280A 

SGR a Mode COL230B 

&GR 9 Mode CP2aO 

&GR10 Mode BW560 

Cesderniers modes sont des modes 16K, les instructions PURPLESOFT 
leursont destinees : &PLOT, &COLOR— , SiBACK=, &PRINT ..etc.. 
La fenetreest fixee a tout I'ecran graph iqueet rempliede lacouleurfixee 
au prealable par &6ACK..... La table des couleurs est deconnectee 
(mais pas modifiee) et f'option de transfert mise A z^ro. 

8.GR Retourd'un mode texte vers le dernier mode graphique utilise. 

Remarque ; contrairement a &TEXT 0, l'instruction SiGR peut etre 
utilises apres un < Ctrl-Reset > 

Note : Executez et llslez DEMO GR16K pour un exempfe commente 
des modes graphiques etendus (modes 16K). 

IMPORTANT : Interferences entre modes texte et graphique. 

Lorsqu'un mode texte est visualise, il est toujours possible de continuer 
a Iravailler sur I'ecran graphique (non visualise) avec les instructions 
&PLOT, &COLOB . &CLEAR .etc.. L'inversc nest PAS TOUJOURS 
possible, si lun des modes graphiques GOL140. COL280A. COL280B 
ou BW560 est visualise et si le mode texte avaitetechoisi par&TEXT2ou 
par &TEXT 4 [tes^te 40 colonnes avec curseur bloc), l'instruction 
Applesoft PRINT ne doit pas elre utilisee jusqu'au retour a une 
visualisation texte. 

De meme. il n'est pas toujours possible de placer 4 lignesde I'ecran texte 
a la place du bas de Tecran graphique ; les modes graphiques COL140, 



COL280A. COL280B Ou BW560 ne peu^^ent etre ■< mixes >■ Qu'avSc un 
mode texte SO colonnes (choisi au prealable par STEXT 5 on aTEXT 6] 
Cette dcrniere possibilite decrite dans la documentation Apple n'est pas 
touiours utile dans la mesure ou i'affichage do caracteres est possible 
sur lecran graphique [mode 16K) avec PURPLESOFT 



V-5 LES POINTS ET LES LIGNES 

Les points et les fignes sont traces par l'instruction &PLOT. 

Pour ceux d'entre vous qui sont deja familiarises avec Applesoft la 
synLaxe de l'instruction &PLOT est simifaire a cefle de imstruction 

HPLOT. 

APLOT X.Y trace un point de coordonnees X.Y dans la couleur 

definie aupgravant par &COLOR. 

5.PL0T TO X,Y trace une ligne de la position du dernier point trac6 
par une instruction &PLOT, a la position X,Y 

&PLOT XI, Y1 TO X2.Y2 TO X3,Y3 TO .... TO XN.YN 

trace une ligne briseede point de depart XT Y1 passant 
par Xi^,Y2 .. X3,Y3 , et finissant en XN.YN 

Dans tous les cas, la couleur du trace est definie par &COLOR— 

IMPORTANT : Dans toui^ les modes^raphfques elendus (16K) I'origine 
des coordonnees est situee en bas et a gauche de .recrsn. le point 
en haul a gauche ayani pour coordonnees 0,191.(ccci est ditferent dans 
le cas de I'ecran graphfque Haute Resolution standard en Basic). 

Note : Executez et listen DEMO UGNES pour un exemple pratique 
d utiJisatfon, 



V-6 LES COULEURS ET LEUR CONTROLE 

V-6.1 Les instructions &C0L0f1— et ABACK— 

acOLOR-n avec n compris entre et 16 fixe la couleur de tracane 
(encre). ^ ^ 

&BACK n avec n compris entre ct W fixe la couleur de remplissaqe 

(papier), '^ ^ 

Consultez I'image qui suit pour la correspondancc entre numero et 
couleur. 
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:=i»n 


^H 8']iarron 


mm - >^j*:.^aL 


■■ 9 :€ran9e 




Mi ld:€ris 2 


^- 


^H ii:]Rose 


^H 4:tJ»rt -fonctf 


^m ±2:V^r± 


IB 5:£irls 1 


^H 13:Jaun$ 


^ 6:Bl«u 


^H 14:Cur«iuoise 


^B 7:Bleu clalr 


^ 15:BUnc 



mode CP280 



Le role de la valeur 16 (couietir tran spa rente) est un pen particutier : 

— En graphisme si on effeclue un &BACK_16 les formes et les 
caracleres soni Iraces sur le fond oxpstanl 

— En texte couleur une instruction &BACK=16 ou &C0L0R=15 a 
pour effel de bloquer la repartitiun des couleurs sur I ecran rriEiis 
n'interdit pas I'impression de caracteres, par I'Jnstruction Applesoft 
PRINT, qui s'inscrivent alors dans les couleurs et sur les fonds 
preexistants, 

ATTENTION : Les 16 coLileurs ne sent pas disponibles en totalite dans 

tous les modes graphiques, 

COL280A, COL280B n'offrent que 4 couleurs : noir, orange, vert et 

blanc pour COL2aOA. Noir. bleu clair. rose r?l jauric; puur COL2S0B. 

Quoiqirjl en soit la couleur donne toujours le noir eJ un trace dans la 

couJeur 16 n'a aucun effet quel que soit le mode. 

En BW560, toute couleur differente de D donne le blanc. 



V'6.2 L'snstrdcVon &SCffNfXXC) 

L'instruction &SCRN(X,Y,C] retourne dans la variable C le numero de la 
couieur du poinl de coordonnes X.Y. 



I, 



Si le point de coorrionnees X,Y n'est pas dans I'ocran d^fmi par Je mode 
graphique dans lequel vou5 vous trouvez, SiSCHNfX Y C) renvoie 16 
dans la variable C. i . , y v.^ .u 



^ 



V-6.3 La prolection cfes couleurs 



Vous disposez a cot effet de la table de comrriande des 
couleurs Vous I'activerez par POKE-26Q7A 1 et la 
desactiverez par POKE-26074,0 



^H Pour modiffer la table de commande des couleurs de 

^^■L^ fapon a ce que tout poinl trace dans Ja couleur C sur un 
* " „ P^'"* deja existani de la couleur E apparaisse de la 

couleur H, effectuez I'instruction : 

POKE -2636a+C I- 1 6 ^E.R 

Pour reinitialiser la table des couleurs a ses valeurs pardefaut ex^cutez 

la sequence d^instructions suivanlo : 

to FOR C._0 TO 15 

20 FOR E-OTO 15 

30 POKE -2636.8-i-CH-16*EC 

40 NEXT E.C 

Pour mieux comprendre le fonctionncment de la labie de commande 
des couJeurs excouter puis examiner le programme DEMO TABLE. 



V-6.4 Operdtions iogiques 

Pour modifier loptron de transfer! et la fixer a la valeur T comprise enire 

et 7 executer I instruction : 

POK£-2E112.T'CALL-25984 



Options do transfert 


a : 


encre 


1 : 


encre ou ecran 


2 , 


encre ou bien ecran 


3 : 


encre el ecran 


4 : 


non encre 


5 ; 


non encre ou ecran 


6 


non encre ou bien ecran 


7 : 


non oncre et ecran 



Pour plus de precisions, consultnr Je paragraphe JV-6.2. 
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V-7 LA FENETRE 

Le positionnement de ia fen^tre s'effec(ue par i'instruction 
&WINDOW G,D,B,H 

Vous fixez ainsi les quatre coles de la fenetre : G.DBH en representant 

respectivement les limites gauche, droite, basse et haute, 

Le remplissage de cette fenetre d une couleur C s'elfectue par 

I'instruction suivante : 

&BACK=C:6<CLEAR 

Ceci esl egalement tres utile pour tracer des rectangles pleins. 

Le programme DEMO FEJNETRE vous donne iin exemple d'utilisation 
dans ce senS- 

Remarque : En made CP280 (-foreground-background"), i^ iirriile 
gauche est Eiulomatiquement arrondie au multiple de 7 inferieur et la 
limite droits au multiple de 7 superieur moJns un. C'est une 
consequence des limilations de ce modc 



V-8 LE CURSEUR 

Un curseur est utilise pour un posltionnement dans les ordres SiPRINT 
(impression do caract^res graphiqitc^s) el &DRAW {tragagc de tableaux 
bicolores). 

Le positionnement de ce curseur sur Tecran graphiQue s'effectue par 
I'instruction &POS X,Y ou X est I'ahcisse de cette position et Y son 
ordonnee. 

L'instructicn &POS peut tres bicn conduire le curseur un dehors de la 
fonelre courante, m^is suuls apparaitront les traces situes a I'interieur 
de cette fenetre. 



V-9 LES CARACTERES GRAPHIQUES 

L'instruction &PRINT permet d'afficher a I ecran graphique des 
caracteres et des ctiaines de caracteres. le premier caracterc utant 
affiche au-dcssus et k droite dc la position du curseur definie au 
prqalable par une instruction &POS. 

Le curseur est ensuile repositionne automatiquement a la fin de cette 
chaine de caracteres. 



ATTENTION : Aucune gestion d'ecran nest cffcctuee, ni passage a la 
ligne. nf -Ecroiling-' M est done necessaire de repositionner le curseur 
pour changer d'ordonnee. 

Les caracteres sent affiches dans la couleur d'encre sur la couleur de 
romplissage, dans les m^mes conditions que les points ou les ligncs 
(fenetre, table de commande des coulcurs...) 

La syntaxe de rinstruction &PPIMT esl identpque a cells de I'lnstructran 
Applcsolt PRINT. II est conseille de la faire sufvre dun point virgule 
afin d'eviter Tinscnption du caraclere graphique correspondant au 
<Return > 

La taillc des caracteres peut Stre multlpli^ee en hauteur et en largeur 

grace a I'instruction &SCALE L,H ou L el H son! compris entre 1 et 
128 et representant respeclivement les coefficients multiplicateurs de la 
largeur et de la hauteur, 

Huit ensembles de caracteres sont disponibJes. L'instruction &CHRS n 
avec n compris entre et 7 permet de choisir. 



SYSTEM. GHARSET (Caracteres americains} 
FRENCH. FONT (Caracteres Irangais] 

BYTE.FONT 
ITALIC. FONT 
GOTHIC. FONT 
ASCn.FONT 
LARGE. FONT 
GREEK.FONT 



SYSTEM. CHARSET est choisi a rinitialisation. 



V-9 LE TRACE DES FORMES 

L'instruction SDRAW n permet de tracer la forme chargee 

en memoire a I'adresse n. 

Le coin en bas et a gauche de la forme sera la position 

courante du curseur graphique (le positionnor 

evenfuel^iemcnt par SiPOS). 

Unu forme a la structure suivante : 

1 "' octet : Hauteur de la fo^-me 

2'' octet : Largeur de la lor me 

Les octets suivants contjennent la forme proprcment dile representee 

en memoire par unc suite de 1 et de 0. 

Les bits a 1 reptesentent les points qui seront traces dtins la couleur 

dencre et les bits a les points qui seront traces dans Ja couleur 
da romplissage. 
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Pour voLis explrquer simpiemont comment coder votre forme en 
memoire, nous aliens recount a un exempfe : 

Supposons que vous desiriez representer la forme suivante : 
xxxxxx 

XX XX 

xxxx xxxx 
xxxxxxxxxxxxxxx 

X X 

Ce dessin est inscrit dans un rectangle de hauteur H^5 (hexa 05) et de 
largeurl — 15 (hexa OF). 

Vous alfez a present .Hire" votre forme de gauche a droife et de bas en 
haut a partir du coin inferieur gauche du rectangle en remplacant 
tes blancs par cfes el \cs x par dea 1. 

000011 111100000 
000011001 lOOOOO 
00T111001111000 

111111111111111 

001000000001000 



Cette operation va vous dooner la suite binaire : 

ucii'docoooaoiOCioi mill 111 nn loom lOGnnnmnaoootiooMODouoocntiii: 

Reorganisons cette suite par series de huit brts en mjoutant 
eventuellement des a la fin ; 



lOOOCO 



1 


OD1OOOO0 






— -^ 


00O1O0O1 






1 


11111111 
n 1 1 11 00 






E 


11110011 
1100OOOO 

01100110 
UOOOOOOO 
11111100 








00000000 






M— J| 


Chaque serie de 8 bits est alors transforme en 


L^ 


de droits a gauche 






m 


bjnaire OOOOOIOO 


hexa 04 


decimal 4 


II 


binaire 10001000 


hexa as 


decimaJ 136 


ts 


bmaire 11111111 


hexa FF 


decimal 255 


tz 


binaire OOllIln 


hexa 3F 


decimal 63 


binaire 11001111 


hexa CF 


decimal 207 


r 


binaire O000OO11 


hexa 03 


decimal 3 


bfnaire 01100110 


hexa 66 


decimal 102 




binaire 00000000 


hexa 00 


decimal 


L 

1 


binaire 00111111 


hexa 3F 


decimal 63 


binaire OOOOOOOO 


hexa 00 


decimal 


b 









un octet en etani rolu 
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Ex^cutez le petit programme suivant : 

10 DATA 5,15,4,136,255,63,207,3.102,0,63.0 

20 FOR f=G TO 11:READ A,POKE768+l,A:NEXT I 

30 S.COLOR = 15:&BACK=0,S:aR7.aPOS13D.95:&DnAW76a 

40 END 

Les instructions 10 el 30 placenl ccltu (ormc aux adrosscs 768 a 779 
L'instruclion 30 trace cette forme dans le mode graphique COL280A. 

ATTENTION ; Choisissez avec soin I'adresse n car vous pourriez sans 
le vouloir ecrascr des donneos et tout voire programme pourrait etre 
del m it. 

II est possible d'agrandir une forme en hauteur et/ou en largeur en 
excculani I'instruclion &SCALE=ML,MH ou ML est lo facteur enlier 
multiplicateur de la largeur de la forme et MH un entier multiplJcateur 
de la hauteur de la forme. 



La sequence d'insfructions 



f;cECALE=2,1 

&DRAW n 



dessinera une forme deux fois plus large que I'original. Muliiplier les 
dimensions d'une forme dimlnuera malheureusement la precision de 
son trace. 



V-10 SAUVEGARDE ET CHARGEMENT DES IMAGES 

Deux petits programmes GRLOAD et GRSAVE presents sur la disquette 
PIJRPLESOFT permettent de charger et de sauvegarder.des imsges 
sur disque. lis uttlisent les routrnes BLOAD et BSAVE du DOS et sont 
ds ce fait assez lonts 

Vous pouvez inclure les sous-programmea utilises, dans vos 
programmes ou vous en inspirez pour concevoir des routines plus 
adaptees et/ou plus performantes. 
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V-11 INFORMATIONS DIVERSES 



V-11,1 Utifisation de compilatBurs Applesoft 



Certains compilateijrs n'implementent pas I'ampersand [&] et li sera 
done necessaire pour les utiliser de transcrire les instructions 
PURPLESOFT par des POKE el des CALL. Le chapilrc -Eve et le 
langage machine " vous donnera toutes les informations necessaires 
a Cette traduction. 
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- ^ V-11.2 Messages d'errBurs 



Trois messages d'erreur peuvent etre retourn^s par PURPLESOFT : 

— SYNTAX ERROR signals une erreur de syntaxe. 

— ILLEGAL QUANTITY ERROR signals urte erreur quantitative dans 

les parametres. 

— BAD SUBSCRIPT ERROR signaie que le mode graphique basse 
resolution est selectionne et qu'il est necessaire d'effectuer lout d'abord 
un SiGR n pour utiliser les. autres instructions graphiques tie 
PURPLESOFT. En particulier, il faut savoir qi/apres un <Ctrl-Reset> 
lApple lie selectiqnne automatiquement le mode graphique basse 
resolution. 



V-11.3 Modification de &GR 

Le fonctionnemenll de I'ordre SGR peut etre moditie par {"utilisateur 
pour eviter retfacem&nt d'ecran et/ou la commutation en graphisme 
dans ics modes 16K. 

Modification de OPTCLEAN 

L'tnstruction POK£-26066,Q permei dovitor ie nettoyage de i'ecran 

proi/Gque par un S.GR ri (n compris entre 6 et 10). 

L'instructiion POKE-26066.1 permet de revenir au fonctionnement 

normal de &GR au niveau de i'effacemcnt. 

Modification de SWITXTGR 

L'instniction POKE-26064.0 permet d'eviter la commutation de 

Taffichage de texte en graphisme provoquee par &GR n (n compris 
enlre 1 et 10) 

Linstruction POKE-26064,1 permet de revenir au fonctionnement 
normal de &GR au niveau de la commutation d'affichage. 



V-11.4 Routine CPCHANGE 

En mode CP280, I'instruction CALL-25996 a pour e(fel de romplacer la 
coulcur de tous les points «allumes^' (bits at) par Ja couleurde tragage 
et celle des points -eteintS" (bils ii 0) pcsr ce'le de remplissage (Cette 
routine n'a d'effet que dans la fenetre graphique el uUlise 
eventuellcment la table de commande des couleurs et I'option de 
transfert). 



V-11.5 Routine TRANSCHAR 

Linstruction CALL-25932 perme! de remplacer le charsel courant 
selectionne par I instruction fitCHnSn par un auire prealablement 
charge a I'adresse ADDR_ 
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— L'adresse -26112 devra contenir la partio basse do I'adresse ADDR 
et I'adresse -26111 la partio haute. 

10 D$-CHR$ (4) 

20 PRINT DS;- BLOAD SPAIN ISH.FOrJT,A16384" 

30 &CHRS7 

AO POKE-26112,0:POKE-26111,64:CALL-25932 

50 END 

Ce petit programme charge en premier lieu Tensemble des caractferes 
espagnols en memoire a I'adresse 16384=64x25G--!-0, initialise le 

contenu des adrosses -26112 et-26l11 puis remplace I'cnsemble des 
caractei'es num^ro 7 par les caracteres espagnols. 



V-11.6 MAXFILES et tNT 

Line partie d«j logiciel PURPLESOFT est logee entre le DOS el ses 
" buffers " et peut done etre delruite par les deux instructions MAXFILES 
et INT. Ne pas utiliser ces instructions si vous desirez consorver 
PURPLESOFT en memoire. 



V-11.7 Utilisation de la page graphique n'^ 2 

Toutes les inslrirctions de PURPLESOFT debranchent fe commutateur 
PAGE2. Si vous desirez utilrser la page graphique n" 2 en executant 
HGR2, notez bien que toule utilisation d'une instruction PURPLESOFT 
replaccra In visual isatron en page n" 1. Conime pour I'instruction HGR 
n oubliez pas de selectionner au prealable fa Haute Resolution-standard 
par SiGR n avec n compns entre 1 et 5. 

L'utilisation de la page graphique n" 2 est de toute fapon rendue 
impossible si vous utilises I'ecran texte 60 cofonnes. 
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Visualisation 
couleur en Pascal 
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CHAPITRE VI 




Visualisation 
couleur en Pascal 



Vl-1 AVERTISSEMENT 

Ce chapitre est reserve aux personnes diaposant du logicici Pascal 
U.C.SD. el ayant une bonne connaissance dans le maniement de ce 
fangage sur Apple ^/e- 

Dans le cas contraire, il est indispensable de lire et d'^tudier 
attentivement fos manuels fournia avec le logiciel Pascal avant 
d'entreprendre la lecture de ce chapitre. 



IV-2 LA DrSQUETTE PASCAL "PURPLE: » 

Votre carte «eve" est accompagnee de deux disquettes dont I'une 
appelee PURPLE: 

II vous faut avant toute chose realiser une copie de cette disquette 
comme indique dans les manuels Pascal alin de conserver loriginal 
en lieu sur. 



^5 Cette disquette procure : 

— une bibliothequo SYSTEM. LIBRARY constituee des unites usuelles 
" Apple " et complfetee par une unite appelee PURPLEGRAPHfCS 

^ ^ specialemenl reaJisee pour profiter de toutes les possibilites de la 

2 -^ carte 'eve"; 

5^^j — un texte de programme PURPLEDEMOTEXTquf tournit un example 

I -^ d'utilisation de I'unite PURPLEGRAPHICS; 

r*^ — le fichier SYSTEM.STARTUP qui est en fait le code du programme 

1^ PURPLEDEMO et qui associe aux fichiers SYSTEM.PASCAL et 

Bi SYSTEM.APPLE permet ['execution de ce programme de 

■— M demonstration des TaJlutTrage de votre APPLE lie; 

j— :s ~ '^ tichier SYSTEM. PURPLE necessaire au d6bu1 de Texecution dun 

m~^ programme utilisant I'unite PURPLEGRAPHICS; 

5"^ — des images graphiques et quelques charsets. 



T 
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Remarque importante : Cette disquetfe i^JE PROCURE PAS les 
(ogiciefs-systeme tie base du PASCAL comme r^diteiir de texte 
(SYSTEM. EDITOR}, Je traitement des ffchiors (SYSTEM, FILER), le 
compilateur {SYSTEM. COMPILER) etc... qui sont fournis lors de I'achat 
du logiciel PASCAL, Elle permel seufement I'executpon du programme 
de demonstratfon. 



Vl-3 L'UNITE PURPLEGRAPHICS 

Vl-3.0 Introduction 

Cette unite met a voxtq disposition un ensemble de procedures et 
de fonctions permettant J'utilisation des nouveaijx modes de 
visuaJisalion couJeur sur vofre Apple //e equipe de (a carte "eve-. 

Dans vos programmes, et avant toute utilisation de ces ordres, il 
taudra placer juste apres i'en-tete : 

uses PURPLEGRAPHICS; 

cette declaration indique au SYSTEME PASCAL d'aller chercher les 
routines grapiiiques dans le fichier SYSTEM. LIBRAHY. 

Le fichrer SYSTEMPURPLE doit Stre en ligne au debut de rex6cution 
dun tel programme (volume 4 ou 5). 
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|[ faut qu'un fichier SYSTEMLfBRARY contenant 
"unite PURPLEGRAPHICS soit sur la disquette qui 
a charge le langage Pascal {"boot disk") aussi bien 
a la compilation qu'a lexecutfon. 

Pour ce faire, vous avez deux solutions : 

— Vous pouvez transferer le fichier PURPL&SYSTEM.LIBRARY sur 
votre disquette d'amonjage (si un fichier SYSTEM.LfBRARY existe 
deja sur votre disquette d'amorgage, 11 est fortement conseifle de le 
sauvegarder auparavant), 

— Vous pouvez transferer I'unit^ PURPLEGRAPHICS dans votre 
SYSTEM.LIBRARY en executant le programme APPLE3:LIBRARY, 

VI-3.1 Les types pred&finis 

PURPLEGRAPHICS met a votre disposition les deux types pr^definis 
suivants : 

GRAFtXTYPE=(HRAPPLEILHRSPEC1.HRSPEC2,HRDASH,MRBW, 
CO L1 40 . COL280 A , CO L280 B , CP280, B W560 ) ; 
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Ceci correspond aux 5 modes de visualisation '-compatibles 
Apple He- utilisant 6K RAM de memoire graphique : 

— a) HRAPPLEII. (pardefauta linitialisation] mode de visualisation 
couleur usuel Apple II en 6 couleurs avoc des Jimitations importantes 
Gl une resolution de 280x192 points (cl Apple IIq roference manual), 

— b) HRSPECl: mode de visualisation couleurenBcoubursidentique 
^ HRAPPLEII mais permettant une nneilleure visualisalion des points 
isoles de couleur sur fond talanc qui apparaissent noirs, ce qui peut 
etre utile, notamment pour la lisibilitc des caracteres graphiques. 

_ t-j HRSPEC2: mode devisuEJiisation couleur en 6 couleursidentique 
g HRAPPLEII mais permettant une meilleure visualisation des points 
isoles de couleur sur lond noir qui apparaissent maintenant blancs 
et des points isoles de couieur sur fond blanc qui apparaissent noirs, 

— d) HRDASH: mode dc visualisation couleur en 6 couleurs identique 
a HRAPPLEII. sauf en ce qui concerne I'atfictiage des lignes 
honzontales dans les couleurs violet, vert, rouge et bleu qui 
apparaissent alors pointillees. 

— e) HRBW: mode de visualisalion noir et blanc qui permet d'obteoir 

sur un ecran couleur cxactement la mcme visualisation que sur un 

moniteur monochrome. 



REMARQUE TRES IMPORTANTE : 

Les 5 modes precedents HRAPPLE2. HRSPEC1, 
HRSPEC2, HRDASH et HRBW sont destines a 
visualiser des images ureees par des programmes 
uliilisanl runite standard TURTLEGRAPHICS, Ces 

images otcupent 8K en memoire principalc et sont appelees 

" images 8K'\ 

L'unite PURPLEGRAPHICS napportc pratiquement pas d'outil 

nouveau pour I'utilisation de ces modes, mis k pari les operations 

suivantes : 

— commutation dans I'un de ces modes pour la visualisation des 
images 8K (cf GRAFIXN40DE cl GRAFIXON); 

— sauvegarde d'une image SK sur une unite de disquette 

(c(. GSAVE) — ctiargement d'une image 8K a piirtir d'une unite de 
disquette (cf. GLOAD). 

IMPORTANT : Elle ne permet en aucun cejs de tracer des points, 
des lignes, de realiser des operations de remplissage cic... 
Pource taire 11 faut utJIiser l'unite standard TURTLEGRAPHICS. 
L'utilisation de l'unite PURPLEGRAPHICS pour ces 5 modes reste 
done tres limitee. 
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Ce type contient aussi les 5 modes de vfauEiJisation utilisant 16K RAM 
de memoire graphiquo : 

— a) COL140: mode de visualisation en 16 couleurs POINT par POJNT 
sans aucune limitation avec une resolution de 140x192 points. 

— b) COL280A: modo de visualisation en 4 coLfieurs (noir oranqe 
vert et bianc) POINT par POINT san?i aucune limitalion avec une 
resolution de 280x192 points. 

— c) COL280B: mode do visuaJlaation en 4 couleurs (noir bleu clair 
rose et jaL;ne) POINT par POINT aans aucune iimitation avec une ^ 
resolution de 280x192 points. 

— d) CP2G0: rnode de visualisation en 16 couleurs avcc une limitation 
a deux OQuleurs mdependantes 5ur 7 points consecutifs mais 
permeltant d'acceder a une resolution de 280x192 points. 

— e) BW5B0: mode de visuafisation noir et tilanc avec une resolution 

de 560x192 pornts- (mode double haute resorution]. 

COL0RTYPE=(CBLACK,CMAGENTA,CDARKBLUECPURPLE 
CDARKGREEN,CGREY1.CMED6LUE 
CLfGHTBLUE,CBR0WN,C0RANGE,CGREY2 
CPINK.CGREEN.CYELLOW.CAQUACWHiTE" 
CNONE), 



-0 CBLACK (Noir) 

— 1 CMAGENTA (iWagenta) 

-2 CDARKBLUE (Bleu fonce] 

—3 CPURPLE (Viofet) 

—4 CDARKGREEN fVerl (once) 

—5 CGREY1 (Gris 1) 

-6 CMEDBLUE (Bleu moyen) 

—7 CLIGHTBLUE (Bleu clajY) 



-8 CBROWN (Marron) 
—9 CORAWGE (Orange} 
-10 CGREY2 (Gris 2} 
-11 CPINK [Rose] 
-12 CGREEN (Vert clair) 
-13 CYELLOW (Jaune) 
—14 CAOUA (Bleu turQuoise) 
-15 CWHiTE (BlancJ 



— IB CNONE (Transparent) : cette couleur '-transparerite>> a ele 
rajoutee pour permettre de tracer un Jabteau de booloens ou 
un caractere graphique sur un fond deja existant. 



VI-3.2 Les variables predefinie$ 

lOERROR.INTEGER; 

VariabJe retournani un code d'erreur (idenllque h lORESULT) lors des 

operatfons d'entrees-sorlios GSAVE. GLOAD ef LOADCHARSET, 

CPrOREGND:COLORTYPE; 

En mode CP280, variable retournant fa couleur des bits a 1 dc la 

cellule de sepl points correspondanl au point de coordonnees fX Y) 

APRES un appef do D0TCOLOR(X,Y|. 



J 
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CPBACKGND:COLORTYPE; . n ^ ■ 

En mode CP280, variable retournant la couleur des bits a de la 
cellule de sept points correspondanl au polnl de coordonnees (X.Y) 
APR^S un appel de DOTGOLOR(X,Y), 

CPCELL:INTEGER: ^ ,„, ^ , 

En mode CP280. varieble retournant le numero (dans 39) de la 
cellule de sept points corrcspondant au point de coordonnees (X.Y) 
APReS un appel de DOTC0L0R(X,Y). 

CPBITINTEGER; „ n. ^ 

En mode CP280, variable retournant le num6ro du bit (dans O.B) dans 
la cellule de sept points correspondant au point de coordonnees (X.Y) 
APRES un appel de DOTCOLOR(X,Y). 

CPBYTE;packed array [0., 6] of BOOLEAN; ■ 

En mode CP280, cellule de sept points correspondant au pomt de 
coordonnees (X.Y) APRES un appel de DOTC0LOR(X,Y). 

VI-3.3 Les procedures de contr6te des modes gmphiques 

procedure TEXTBG; 

Le texte 80 colonnes sera afflche en noir et vert 

procedure TEXTBW; 

Le tcxie 80 colonnes sera afliche en noir et blanc. 

procedure GRAFIXIV10DE(G:GRAFIXTYPE); ,„„,,.„ , , 

G devient le mode graphique courant (initialise i HRAPPLEII), de plus . 

— I'&cran graphique est nettoye dans la couleur fixee par PAPER 

— la feneire est ramonee a tout I'ecran 

— la table des couleurs est inactivee 

— I'optlon de transfert est mise a 

Ce fonctionnement peut etre modifie par Tulilisation do la procedure 

CLEANOPTION, 

procedure CLEANOPTION(C:BOOLEAN}; 

Change le comporlement de la procedure GRAFIXMuub. 

C- Option de nettoyage d'ecran. 

Si C^TRUE (valeur normale). la procedure GRAFIXMODE se comporte 

comme d^cril ci-dessus. 

Si C=FALSE la procedure GRAFIXMODE ne nettoie plus I ^cian, 

le fonctionncment de la table de commande des couleurs et de I'option 

de transfert reste inchange. 

Romarque ; L'option C ne joue aucun role dans les modes ^.BK", 

I'ecran n'cst jamais neltoye. 

IV-3.4 Les procedures do contrQfe de f'affichage 

procedure TEXTON; 

Place Tecran en mode texte. 



70 



procedure GRAFIXON; 

GRrPIXMODE '''' '^ ^^''''^ graphique defini aupgravant par 

procedure MIXON: 

^nf^L'ii^'"^" '" ^'^^ graphique defini auparavant par 
GRAFIXMODE et remplace le bas de I image par 4 lignes da I ecran 



VI. 3,5 Le controls des couleurs 

procedure TABLEOFF; 

U tabfe de commande des couleurs nest pas utilisee, toules fes 
operations de Imgage et de remplissage sont plus rapides. 
procedure TABLEON; 

La table de commande des couleurs est utilisee elJe permet la 
protection de certaines couleurs ou leur transformation lors des 
operations dc tragage et de rernpirssage. 

procedure SETCTAB(NEW,OLD,RESULT:COLORTYPE) 

Transrorrm la table de commande des couleurs de fagon a ce que toul 
poirjt trace dans la couleur NEW sur un point de]a exist.nt de 1. 
couieur ULU apparapsse a lecran de la couleur RESULT. 

iNbWCOLOR sur des points de couJeur OLDCOLOR. 

procedure IMITTABLE; 

Remet le contenu de la table de commande des couleurs d^^ns son 

elat a I in.tral,satJon (c.a.d. pas d'effet s.ur les couleurs specitiees). 

procedure XFROPTiON(OPTIOiN:rNTEGER)- 

Choisit roption de transfer! pour toutes les operations de trac^jqe et de 

em^P ?f 4 hiri''^^ ^^' operations logiques sui.antes est appNquee ' 

enlre les 4 bits du numero d'ordre (binaire) de la couleur SOURCE 

Jssue de la lable de commande dos couleurs si elfe est activee 

^^la'coXrr o'LlTl-e'o'ian'^ '^™ ^' ^"^ ''' ''''^''^' '^ '- ' ''^ 



— 



2^\'?^rPJ"' ^^*^''^' '■■'Impression se tart dang la couleur 
tiOURCE queJIe que soit la couleur OLD. 

Option " ou inclusif >v. la coufeur SOURCE OU OLD est 
imprimee- 

OpHon ''inversion", la couJeur SOURCE OU BjEN OLD 
est jmprimee, Cette option peut etre tros Lrtile car elfe 
pormet de tracer une premiere fois sur un fond comnicxe 

avec un resultat visible el de reobtenfr le fond en 
retragant une deuxieme fors. 
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— 3 : La couleur SOURCE ET OLD est imprimee. 

— 4 : Option "-negati*-, la couleur NONSOURCEe&timprim^e. 

— 5 ; La couleur NON SOURCE OU OLD est imprimee. 

— 6 : La couleur i^ON SOURCE OU BIEN OLD est imprimee- 

— 7 : La couleur NON SOURCE ET OLD est imprimee. 

procedure lNK(C:COLORTYPE), 

Trempe - la plume^ dans la boutetlle d'encre de la couleur C. 

Ceci a pour effet de choisir cette couleur comme couleur de tragage. 

procedure PAPER[C:C0LORTYPE); 

Prepare une feuille de papier de Ui couleur C. 

Ceci a pour eflet de choisir cctte couleur comme couleur do 

remplissage. 

VI-3.6 Le conirafe du curseiir 

Afin de permettrc une plus grande souplesse dans I'utilisation des 
procedures qraphiques, PURPLEGRAPHIQS tolere Icmploi d un 
curseur fictif analogue a la Mortue - de TURTLEGRAPHICS Ce 
curseur peut subir des deplacements relatifs ou absolus, et meme 
laisser une trace de son passage dans une couleur determinee , 
ccci permet de considerer I'ecran comme une teuille de papier d'une 
couleur donnee. sur laquelle lutilisateur dessine avcc un stylo a oncre 
qu'il -promene- sur la feuille.- Le curseur peut etre positionne 
nimporte ou, meme a I exteneur de la fenelre. 

function XCURSOR:INTEGER; 

Retourne I abscisse du curseur graphique. 

function YCURSORMNTEGER; 

Retourne son ordonnee. 

procedure MOVEABS(XCOORD.YCOORD:INTEGER1; 

Place le curseur au point de coordonnees XCOORDYCOORD sans 

rien tracer, 

procedure MOVEREUDX.DY.INTEGER); 

Translate le curseur de DX,DY sans nen tracer: le curseur sc retrouve 

a la position IXCURSOR^DX.YCURSOR- DYj. 

V1-3.7 Le controle du trac€ des points 

Un point est trace soit en donnant ses coordonnees X et Y 

( DOT(X,Y) ) soit tout simplement a I'ernpiacement du curseur 

( DOTCURSOR ) 

Outre le tragage des points. PURPLEGRAPHICS procure un ensemble 
de procedures permettanl de tracer des lignes. Une ligne peut ctre 
tracee en donnant les coocdonnees du point de depart [XSOURCE, 




p 



VSOURCE) et ivelles du point darnVee (XBUT Yni it* i i- 



(DX.DY) 
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— point d'arriv^e 
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position du Curseur 



procedure DOTfXCO0RD.YC00RDi;^TEGERl- 
Trace un point en XCOORD.YCOORD dans ia fenelre. 

procedure LlNE{XFROM,YFROM,XTO YTO-|>JTEGERr 

procedure DOTCURSOR; 
Trace un point a Ja position du CtJrseur. 
proceduro LJNEREL (DXDYJNTEGERl- 
YCUR.SOR+DY. et Iranslaie fe curseur de DX DY 
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procedure WINDOW (LEFT,RIGHT30TTOM,T0P,INTEGER); 
Place une fenetre dans lecran ayant pour limJtes a gauche LEFT, a 
drojle RIGHT, en bas BOTTOM et en haul TOP, CeJa permet de 
proteger cettaines zones de I'ecran. 

En mode CP280. la fimite gauche est 
aulomatiquement arrondie au multiple de 7 infi^rieur 

el la limite droite au multipie de 7 superieur 
-moms un. (Voir explications sur le fonctionnemcnt 
du mode CP280). 

procedure FILLPORT; 

Place sur ia fenetre Ig papier de couleur prepare par PAPER aux 

dimensions definies auparavant par WINDOW, 

procedure CPCHANGE; 

Ne tonctionne qu'en mode CP280: modifie la partie couleur des points 
^aliumes" ou ^eteints" situes dans la teneirc. ies points '=allumes" 
apparaissant dans la couleur fixee par IJNJK et les points «etelnts^' 
apfaaraissant dans la couleur frxee par PAPER. Toutes ces operations 
utilisent eventuedement la table des couleurs puis I'cption de transfert. 

VI-3.S Le trace de tableau de bpoto^ns et de caracleres gisphiques 

procedure DRAWARRAVfvar PICTURE:packed record 

WIDTH, HEIGHT:0.. 255; 

TAB:packed array 

[T.longueurJ 

of BOOLEAN end); 

Impression d'un tableau de booleens dans les memes conditions que 
le DOT. Le tableau peut etre de talNe quelconque. mais afin de 
gagner de la place memoire, il doit etre compacte en un tableau 
unidrmensionnel. Sas dimensions reelles sent passees comme 
parametres dans les variables WIDTH el HEIGHT du RECORD, 
longueur doit etre le resultat de la multiplication : 
PfCTURE.WIDTH^- PICTURE, HEIGHT 

Exemple ; pour tracer des images de 5 points de large et 7 points 
de haut, il faudra utiliser une variable DESSIN 

DESSINipacked record 

LARGEUR,HAUTEUR:0..255; 
IMAGE:packed array [1.35] of BOOLEAN 
end; 

II faudra faire fes assignations : DESSlN.LARGEUR:=5i 
DES£IN.HAUTEUR:=7; et le lableau DESSIN IMAGE sera rempll 
av'arit J'appnl do la procedure DRAWARRAY. 
A I'ordre « DRAWARRAY {DESSIN);- les 5 premiers - bits- de 
DESSIN. IMAGE sont atfiches de ta position du curseur vers la droite, 
les 5 suivants juste au dessus... 
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Les 1 du tableau (ie les valeiirs TRUE) soni dessines dans la couleur 
dsterminee par INK; les du tableau (ie les valeurs FALSE] sont 
dessin^s dans fa couleur determinee par PAPER Celle procedure 
utilise les facteurs do repelition determines par la procedure SCALE. 

procedure SCALE(XFACTOR,YFACTOR:iNTEGER); 

Initialise les facteurs de repetition utilises dans la procedure 
DRAWARRAY. PRINTCHAR et PRINTSTR. XFACTOR devient Ie 
multiplicateur du nombre de points par ligne (largeur), YFACTEUR 
Ie multiplicateur du nombrg ds lignos (hauteur), 

procedure PRINTCHAR{CH;CHAn): 

Impression du caractere CH appartenant au charset utilise, a la position 

du curseuf, dans n'importe quel mode graphique (memea conditions 

que Ie DOT), avcc les couleurs determinees par INK et PAPER 

(cf DRAWARRAY). Un deplacement relatif horizontal du curscur de 

7*XFACT0R est elfectue. 

procedure PRINTSTRfS:STRfNG); 

Memes conditions de fonctionnement que PRINTCHAR, mais c'est la 

chatne touts entiere qui est imprimee Le curseur est deplace en 

consequence. 

procedure CHARSET(N:INTEGER): 

Determine 3e charsct qui va etre utilise. N doit etre compri& entre et 7 

sinon rien n'est change. 

N— : SYSTEM, CHARSET [CaracE^res amehcalns) 
N=1 : FRENCH FONT (Caracteresfrangais) 
N-2 : BYTEFONT 

N^3 : ITALIC. FONT 
H=:4 : GOTHIC.FONT 
N—5 : ASCII. FONT 
N=6 : LARGE.FONT 
N=7 : GREEK.FONT 

procedure LOADGHARSET(S:STRING): 

Charge a ia place du charset utilise Je charset sauve sous le nom de 

fichier S. (attention a la structure de ce fichier, cf Chapitre VIII). 

Remarque : un "charset- est du type Pascal packed array [0.,127] 
of packed arryy fO .7] a( CHAR. 
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procedure PROTECT{B:BOOLEAN); 

Protection lors dun GSAVE, si B-TRUE toute tentative pour sauver 
une image sous un nom deja exfstant est inoperante et lOERROR est 
retourne avec la valeur 11. 



VI-3.10 Les conditions initiales 

Au lar^cement du programme. Tunite PURPLEGRAPHICS initialise 
un certain nombre de variables et de fonctions. En voici la liste : 

— Mode graphique HRAPPLEII (mode Apple lie standard) 

— Fert^tre ....,, tout I'^cran 



(0,0) (en bas et a gauche) 
CWHITE (blanc) 
CBLACK (noir) 
normaie (0) 
normaie et inactive 

— Echelle facteur de repetition horizontal 1, vertical 1 

— Charset numero (am^ricain) 



Position du curseur — 

Couleur de tragage 

Couleur de remplissage 
Option de transfert . . . 
Table des couleurs 



VI-3.9 Ld saw^garde des images 

procedure GSAVE(PATHNAME:STRING); 

Sauvugarde de I'image sous le nom de fichier PATHNAME suffixe 

par FOTO 

procedure GLOAD{PATHNAME:STRING): 

Chargement de I'image sauvee auparavant sous le nom de fichier 

PATHNAME par GSAVE, Ccttc procedure rennet le mode graphique 

correspondant. 
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L'extension 
memoire 64 K 



VIM POURQUOI UNE MEMOIRE AUXILIAIRE ? 

L'Apple lie. dans sa version standard, contient d6j^ sur sa carte-mere 
64 K-octets de memoire utilisateur. 

Le microprocesseur 6502 qui I'equipe ne peut effeclivement adresser 
que celte quantite de memoire; aussi peut-on se demander a quoi 
servent les 64 K-octets supplSmentaires enfiches sur votre carte. 

Pour le comprendre, imaginez une grande avenue oO chaque maison 

sur le trottoir de droite ferait face a une maison sur ie trottoirde gauche 
et ou toutes deux porteraient le meme num^ro. 

Cette avenue est tres longue ; les numeros vonl de ^ 65535 et en fait 
chaque maEson represente un octet (64 K = 64x1024 65536 ■■ maisons^ 
ou oclets). 

Lorsque vous marchez sur le trottoir de gauche, vous etes dans la 
memoire principale : sur la plaque de I'Apple lie; sur le trottoir de 
droite vous vous trouvez dans la memoire auxiliaire : celle de votre 
carte eve, 

A present, !a question se pose de savoir comment passer d'un trottoir 
a i'autre : ceci est realise par I'intermedlaire de commutateurs logiques 
(les " switches » pour les inities) que Ion peut actionner facilement par 
programme, lis permettent de traverser I'avenue a des adresses 
precises- 

Le fait d'ecrire (en Basic par POKE adre&se, valeur) ou de lire {par 
PEEK [adresse)) a certaines adresses memoire indiquera a I'Apple lie 
ce qu'il doit porter a Tecran et ou il doit lire/ecrire les donnees qui 
lui sont necessaires : memoire principale et/ou auxiliaire. 

L utilisation de ces commutateurs logiques est reserv^e aux 
programmeurs AVERTIS et aux logicleis developpes pour lApple lie 
par des professionne'ls- Une mauvaise utilisation peut rendre votre 
ordlnateur lou 'f 

Vousn'auriez plus alors qu'a relancer le systems en pcrdant tout espoir 
de retrouver vos donnees et votre programme,., 




La (Tnc-moire auxiliaire permet cfonc de doublet l.i m^mcire de votre 
ordmalaur La plupart des programmes congus pour Apnfe //e ^rnnt 

a^antage de cette memoire additponnelle. 

La visuafisalion dir tsxte en SO colonnes utilise IK de CGtte mpmmr^ 

^S:^k"i ""T" ?T^^''^^^^ ^^^"^^^ (doubleV/ute m'oTuTnnnn 
u sont 8K. Les (ogiciels gmphiques fournis par Le Chat M.uve en 
utilise one parl.c (consulter a ce sujel te chapme VIII. p'r.g'apho i 1.). 



^™DUES^^'°'^'^^'^^'^"^ °^^ VISUALISATIONS 

b,en determinee". Ce^zSnefsont' r^^p^lLr; ;,^^ 

Lire Ik tabfeau de ces zones. (TabJeau VJJ-l) 



VI I -2.1 



Commutation des dimrents modes de visualisation 



Ces modes sonl selectJonnes en ^crivant ou en lisBnt a certame^ 
adresses servant de point d'entree aux commuta eurs fnafn 1 i^ 

connpcter, Tautre pour les debrancher et le trois.ernfpour NrP leur etat 

- MIXED 'cVhirf^ Vll-2 sur lequei voic, quelqu.s reniarques : 

est dibfanche " °'' ' '''" '^" '" ^---^'isatic, que Inrsque TEXT 

r. ^^ ^''l^^'l^"''^''* '^^ SOSTORE modlfie Is fonction de PAGE? 
Lorsque SOSTORE est branche, PAGE2 na plus d e?fct sur fa 
.isualisaiion texto mais permet alors au processeur d'adrcLser soit 
a zone ecran texte en m^morre principale (page sa^Ta "one^Ln 

part^un.rc'ds'pAC^^";'" '''^' '^^^ ^^ '"^^'^ de ceHj'utSf'on"' 
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En temps normal, cea commutateurs sont geres par les instructions 
et commandes permettant de selectionner un des modes de 
visualisation [par exemple en Basic; TEXT,GR,HGR.PRfl3,..). 

Voici un petit programme Basic qui vous permettta de mieux 
comprencfre : a cet effet. sachez que iorsqu'un commutateur logique 
est branche, la valeur lue est superieure a 12B et inferieure a cette 
valeur dans le cas contraire. 



10 FOR 1=16360 TO -16353 : SW(I 
20 PRINT «&0STORE =^SW[0) 



16360)=PEEK(I):NEXT 



30 PRINT 
40 PRINT 
50 PRINT 
60 PRINT 
70 PRINT 



TEXT^ -■;SW[2) 
'MIXED = ^SW(3] 

PAGE?— ";SW{4) 
.HIRES — >';SW(5) 

30COL - -;SW(7] 



Executez ce programme a I'altumage de lAPPLE IIq puis tapez PRirG 
et recommencez; essayez encore apres un Esc 4 puis apr^s 
un HGR . .etc. 



VII-2.2 Utitisatlon ditecte des commutateurs d'affichgge 

Pour actionner fes commulateurs logiques SOSTORE et PAGE2. il est 

necessaire de passer par un programme. En elfet, des que I'APPLE He 
affiche du toKte a I'ecran en mode 30 colonnes, II utilise ces 
commutateurs logiques. Votre action ne dure ainsi que Ic temps de 
votre programme- 

a) Pour le texte SO colonnes 

La page 1 du texte en memoire principals a son "reflet" en memoirs 
auxillaire aux m^mes adresses, appele page "fX texte. 

Pour stocker directement des donnees en page IX, il faut brancher 
le 80STORE en ecrivant a I'adresse 49153 (INTEGER BASIC : 
-16383. HEXA: SCOOI ) puis actionner PAGE2 en ^crivant ou en fisant 
a I'adresse 49237 (INTEGER BASIC: -16299, HEXA: $C055). 



Pour un petit essai, activer la fonction 
Je programme suivant : 



I colonnes par PR #3 et executez 



10 HOME 

20 FOR 1=1 TO 10:nEAD A$:POKE 1462-|-I.ASC(A$)+128: 

GOSUB lOOOiNEXT 
30 POKE 49237,0 : REM branchement de PAGE2 
40 FOR 1=0 TO 11:READ ASjPOKE 1462-i I,ASC{AS)-|-128: 

GOSUB 1000:NEXT 
50 DATA E.O, I.A.I, N,E."",A,E.1 
60 DATA M.M,R,S.T,Or ■.N.,P,G,- ",X 
70 END 
1000 FOR T 1 TO 200:NEXTRETURN 
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Lfis premiers caracttiros qui apparaissent en colonnes impairea soni 
inscnts en memolr-e prjncipale, les suivants en memoire auxiliaire 
aux memus adrcsses 



b) La haute resolution etendue 

En mode graphique 560 points noir et blanc (double 
haute resolution), la repailition memoire est sirnllaire 
a celle employee pour \u Uunie resolution standard. 
Dans chaque octet le bit de poids lort est ignorti, un 
octet correspond done a 7 points affiches, 

On visualise ^0 paires de M points par ligne, les 7 premiers 
de ctisquu pairc 6tunt en mtimoire auxiliaire tpage IX 
graphique). les 7 autres en memoire pnncipalG (mSme 
adresse). Ainst les points a 6, 14 a 20..., 545 a 552 
igne sont implanles en page 1 X graphique. Les points 7 
.. 553 a 559 Eont eux en page 1 graphique {memoire 




d'une meme 
a 13.21 a 27. 

principale). 



Pour atookcj- dcs donnees directement dans la page 1X graphique. 
branchez BOSTORE et HIRES puis PAGE2 

Note : lo branchement des deux commu'tateurs BOSTORE et HIRES 
est necessaife pour modifier le role de PAGE2 au niveau du graphisme 
haufc resolution. Le commutateur d'aftichage se transtorme alors en un 
commutateur memoire pnncipaie-auxiliaire sur les zones memoire 
$2000-S3FFF ct S.400-S7FF. 

Pour visualiser un mode graphique doubfc haute resolutian il faut que 
80COL ct HIR.es soit branches, que TEXT soit dehranche, ot do plus 
que le commutateur AN3 soit debranche [AN3 est branche a I'allumage 
de I'Apple //e) 



a e 



3E 




■-^ 



^ !=. 



S3 



VII-3 ACCES UTIUSATEUR A LEXTENSlON MEMOIRE 



^ 



Commutateur AN3 : -on" : C05F (hexa) 

("annunciator 3 >>} ■ off" : COSE (hexa) 



-16289 (decimal) 
-15290 (decimal) 



Une serie de commutateurs permettent un acces selectit 
a la memoire auxiliaire. 

fMK Le tableau VII-3 presents I'ensemble de ces 
jUHn commutateurs, Les figures VII-1 a VII-4 expliquent le 
^ESf" fonctionnement de ces commutateurs. Chaque fjgure 
^B^ presente I'actfon d"un commutateur marque d'un X. La 
j^HL memoFre active est celle presentee au microprocesseur, 
^HH independamment de Cetat de ce commutateur Les parties 
^^■^^*^™^ "Commutocs" sont celles soumisGs a Taction de ce 
commutateur qui en presente au microprocesseur, soit la memoire 
principale, soit la memoire auxiliatre. 

Les commutateurs RAMRD et RAMWRT permettent de valider 
independamment les fonctions. d'ecrliure et de lecture dans les deux 
espaces memoire S0200'$BFFF. A ces adresses, il est done possible de 
lire en memoire principale et ecrire en memoire auxiliaire 
*ou vice-versa). 

Les commutateurs d'acces au pages d'ecran ont priorite sur les 
commutateurs RAMRD et RAMWRT. Lorsque SOSTORE est branch^, 

les deux espaces memoires S400-$7FF sont selectJonnes 
independamment de I'etal de RAMRD el RAMWRT par Taction de 
PAGE2. Si de plus HIRES est branche, il en est de meme pour les 
deux espaces memoires $2000-S3FFF. 

La memoire morte contenant Tinterpreteur Applesoft est en parallele 
avec la " bank svi/itched memory^^ (zone memoiire $DOO0-SFFFF), Son 
activation est independante deTetat des commutateurs du tableau Vil-3, 

Pour plus de precisjons, se procurer !'« Apple He Reference Manual «. 
Ce manuel est indispensable pour utiliser toutes les possibifites 
de I'AppJe He au niveau de la gestion memoire. 



En Ce qui concerne la visualisation couleur. d'autres commutations 

peuvent etre necessaires pour choisir parmi les differents modes 
graphiques eiendues de la carte eve (consulter a ce sujet le chapitre IX. 
paragraphe 1). 

Note . le iogiciel Tourni avec la carte prend en charge toutes les 
commutations d'affjchage. 

Les pagcij graphiques 1 et IX sont utilisees par tous les modes de 

visualisation etendue de la carte eve. 
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VII-4 LES SOUS-PROGRAMMES 
DE LA MEMOIRE AUXILIAIRE 

Deux sous-programmes impJantes en ROM (memoire morte) sur votre 
Apple //e facilitent TutMisation de la memoire auxilraire. 

Installes dans I'espace memoire $C300-SC3FF reserve au slot 3 leur 
acces reste independant de Tetat des commutateurs de memoire decrits 
dans ce chapitre. 
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paragraphe vir-4, 
des images " 16K 



VII-4.1 La routine AUXMOVE 

Cette routine situee en SC31 1 permet do transferer 
des blocs de donnees de la memoire principals vers 
la mernoire auxiliaire et vice-versa, mais seulement 
dans I'espace memoire S200-$BFFF. 



ATTENTION : Lorsque BOSTORE est branche certains espaces 
rt^ , memoires apparaissent a cette routine 

JC^ ^^^ comme etant a la fois en memoire 

principale el en memoire auxifiaire En effet 
cette routine utilise les commutateurs RAMRD 
et RAMWRT sur lesquels BOSTORE prend 
priorite. Revoir eventuellement a ce sujet les 
explications du paragraphs Vil-2 et los 
figures Vll-f et VII-2, 

Cette particularity pent etre bien utile, vous 
pourrez consulter a ce propos, au 
Ic programme TRANSFOTO de sauvegarde 
' (haute resolution etendue) en memoire auxiliaire. 

Avant tout appel de cette routine [en assembleur JSR $031 1} ii taudra : 

— positionner le bit de retenue (carry) du microprocesseur en fonction 
du sens de transfert ciioisi. a 1 (par SEC en assembleur) pour un 
transtert de la memoire prfncjpale vers Ja memoire auxiJiaire, k 
(par CLC en assembleur) pour I'autre sens; 

— charger i'adresse de depart des donnees a transferer en S3C (partie 
basse de cette adresse) el S3D (partie haute). Le pointeur $3C/$3D 
est appel^ A1L/A1H; 

— charger I'adresse du dernier octet a transferer en S3E (pailie basse 
de cette adresse) et S3F [partie haute). Le pointeur $3E/$3F est 
appele A2L7A2H; 

— charger ladresse de cfestination du bloc de donnees en $42 (partie 
basse de cette adresse) ct ?43 (partie hauie), Le pointeur $42/S43 
est appele A4L/A4H; 

Remarque impoitante : En Pascal, ies pointeurs Al. A2 et A4 en 
page zero sort utilises par le systeme. Pour pouvoir utiliscr AUXMOVE, 
il est done indispensable de les sauvegarder pour les restaurer ensuite 
apres le Iransfert, 

Le programme assembleur TRAIVSFOTO dont le code est present 
sur la disquette Basic DOS 3.3 PURPLESOFT apporte un tres bon 
exemple en Basic de maniement de ia routine AUXMOVE. Son Ifsting 
est donne au paragraphe VII-5, 
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Liste des paramStres pour AUXMOVE 



nom adresse 



fonction 



carry 



1 : memoire principale vers memoire auxiliaire 
: memoire auxiliaire vers memoire principale 



AIL $3C partie basse de I'adresse du premier octet a transferer 

A1H $3D partie haute de I'adresse du premier octet a transferer 



A2L $3E partie basse de I'adresse du dernier octet k transferer 

A2H S3F partie haute de I'adresse du dernier octet a transferer 



A4L $43 partie basse de I'adresse de destination (1^' octet) 

A4H $43 partie haute de I'adresse de destination (1'-' octet) 




VII-4.2 La routine XFER 

JUl La seconde routine permet elle de transferer le controls 
I^B a un sous- prog ram me residant en memoire auxiliaire ou 
|EJU de ie "rendre- a un sous-programnne de la memoire 

^^F principale. 

^^ft llestalors necessaire de preciser si la memoire principale 
^^^Hl^ "passe la main- a la memoire auxiliaire ou vice-versa, 
^*^^^^^ il faut auHSi, preciser si le programme auquel on donne 
le controle utilisera la pile et page zero en memoire principale ou celles 
de la memoire auxiliaire, enfin il faudra evidemmenl donner I'adresse 
du debut de ce sous-programme. 

— Le positionnement de la retenue (carry) determine le sens dans 
lequel s'effectue le transfert de controle : si la retonue est a 1 (SEC), 
la memoire principale passe le controle a la memoire auxiliaire. Si la 
retenue est a (CLC) c'est ators la memoire auxiliaire qui transfere 
le controle a la memoire phncipaie. 

— Le positionnement de I'indicateur de depassement (overflow) 
determine quant a lui la pile et la page zero utilisees par le 
sous-programme : si est indicaleur est a 1, la pile ot la page zero 
de la memoire auxiliaire seront utilisees. S'il est a 0, la pile ct 

la page zero de la memoire principale seront utilisees 

— Enfin I'adresse du sous-programme auquet on donne le controle 
doit etre placec en S3ED pour la partie basse et $3EE pour la 
partie haute. 
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Remarque tr^s importante : il est preferable de transferer le contrfile 
k voire sous-programme par i'mstructfon JMP XFER [JMP 0C314) 
Dt non par un CALL (JSR 0C314) , ceci essentiellempnt pour des raisons 

d& geslion de pile Ao moment de I'appei. une pile est activee 

mais au retour ... (a mediter, croyez-nous, les auteurs de ces quelques 
lignes en ont fait la iriste experience), 



Lists des parametres pour XFER 



nom et adresse 



fonction 



Carry 



Overflow 



: memoire pnncipale vers memofre auxiliaire 

1 : memoire auxpJiaire vers memoire pnncipale 



1 : page zero et pile en memoire auxifiaire 
; page zero et pjje en memoire principale 



S3ED 
$3£E 



partie basse de J'adresse de debut du programme 
partfe Inaute de I'adresse de debut du programme 



VII-5 EXEMPLES D'UTILISATION 
DE LA MEMOIRE AUXILIAIRE 

VII-5.1 Exemple d'uWlsation de la routine AUXMOVE en Bssic 

Le programme liste ci-dessous s-appcile TRANSFOTO et permet Je 
transfert d'irnages 16K utilisant les pages graphiques 1 et IXaux 
adresses $4000 a $7FFF (bufterl) ou aux adresses $8000 a Sbfff 
(buffer2} en memoire auxiiiaire. Les transferts peuvent s'effectuer 
dans ies deux sens II est fci ecrit pour fonctionner en Basic cl le code 
est fourni 3ur la disquette Basic DOS 3.3 PURPLESOFT, 

Par exemple. Tappel du petit sous-programme suivant permettra si 
1—1 de sauver lea pages graphiques 1 et IX dans le butler 1 et si 
l_2 de ctiarger fe oorrtenu du buffer 2 en page 1 et IX. 

T0DS=CHRS(4) 

20 PRINT D$:"BLOAD TRArJSFOTO ASSOD- 

30 POKE 768,J:CALL 769 

40 RETURN 
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Lfsl^ngde^ TRANSFOTO 

Si CHOIX [adresse S300 ou 768 dec) contient : 

tes adresses deS4D00 a S7FFF en aux seronlchargees 

en PAGE1 et IX 

les PAGEl el IX seront sauvegardees de S400D a 

$7FFFen aux 

les adresses de S80QO a SBFFF en aux seront 

chargees en PAGE 1 et IX 

^^.^ 3 . ies PAG El et IX seront sauvegardees de S8000 a 

^en'aux apres I'appei du sous-programme TRANSFOTO 
en $301 ou 759 dec 




.ORG 300 



OIL .EQU 3C 

fllH -Ecy 3D 



i\2L -EDLl 3E 

fi2H .rau zr 



AIL 

A4H 



cHon 



.EBU 4£ 
.EOU 43 



.&VTE 00 



;adrB5tiC de depart, partie ba^se 
ladresse de d^fart. p-iirtiE haute 

iilerniere Bdregse a trans+Srer, partis haiitp 



iiidresge de destifiati nn, partie basse 
;adrei*se de cleatinstiori. partie hauta 



TRAfJSFOTO PHA 

PHfi 
SEI 



LDft nctiiD 

PHA 

LDfl or:i:ilB 

PHft 

LW OCfilC 
PHA 

LDK CHOIX 

STfi OC057 

STfi oraPi 

LOfi 4tO 
STA ALL 
5TA A4L 

LDfl WOFF 
5TA fl2L 






1 &dLiVBgarde d* I'^^tat de HIRES 

;BauvB^srde de 1 ' itst de Bi^BTORE 

;5auvcgdrde de I 'fttet de PflEE:2 

iCHCIK ddn^ X 

; HIRES on 
ifilySTClBE: an 



lini^^ialisation dee Rarties bassies dps pcirteurs 
;fli, ftS, A" 



b 
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LDfi RTART1,)( 
STfl AlH 

STA A2H 

STfl fl<tK 



STfl OC054 

TXft 

ROR A 

JSR AUXMOVE 

LDfi #0 
STA fllL 

3Tfl flflL 
LJ>fl tlOFF 
STPi A2L 

LDA STPiRT2,»; 

STA fllH 

STfl A^H 
LDfl DEBT2,y 
STfl flIH 

STfl 0D355 

TXfl 
f^OP A 

JSR flUSTMOVE 

PLfi 

BMI OLDSTGRE 

OL:>STffl*E PLfl 

BMI OLBHIRES 
STA OCfi'lO 

OLDHIRES PLA 

STfi OCrsfi 



OLDX 



PLP 
PLfl 
TAX 
PLA 
RTS 



rcbargemprt d*n5 «1K de U pdrtie hsute de J,"-drBE5e 

jchargenient dans srH de 1^ (j^rtie hailtf> de U 

;rhargeirer.t dsr,^ A4H de la partie hayU de ] 'adre^^e 
rde de-5tination 



iflrcts PAGEl 



ior fait tombpr t» ftit de ^.^irit^ rte K dili'is Id carry 



;["einitieliBaticn des sorties bashes des pojrhteurs 
;A1. ft2. fifl 



IcJi^rgement dans AlH de la pertie hiaute d* radrt-s-se 

;dp depart & transferer 

nchargemppt dans ft2H de Is partie iisutm He l? 

jde'rrl^i-B adreew S transi+Srer 

ichargeraent dfln= fl4H de la partie Inaute flP J-'edrsirae 

; dp derLtimati nn 



iufi fait tomber le bit rle pan Li de K dan^. lii carrv 

jtran^fert PAQEIK '.■---. fill), 



;i-effii&e en ttst de PA6E2 



;r*(nUf en £-tit dp RrhBTORE 



;remi9e en ii^t de HTRFS 



}rs!^i9B en ^tat :< et fl 






jtahl^aii dEs s(-drff55P5 haute& 

STflRTl ,£iVTF 40. 20, Bt*. 20 

START? .BVTE 60.20. nfic., JO 

ENDl .EVTE 5F,5F,?F,3F 

fWDJ .Hytf 7F,3F.0SF..~F 

DESTl .BYTE 20.40.20,130 

OFEir .PVTE 2tl,hO,2C'.Ofl-i5 






b 



E 



E 
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VII-5.2 Exemple d'utUi$glion 

de Id routine AUXMOVE en Pascal 

procedure MAINAUX (var X;TAILLE.ADDR: 
fNTEGERj;exterTial; 

procedure AUXMAIN (ADDn.TAtLLE INTEGER: 
var X);external; 



a placer dans le programme utiJisateur ') 



NoLfS donnons ici un exempie de procedures e)(tcrnes bien pratique 
permGltant la sauvegarde de i/ariables en memoire auxfliaire puis 
ieur recuperation, En tant que procedures extornes, il facit pour les 
utiJiser compiler Je programme, puis lier ie code ubtenu avec le Jichier 
TRANSPORT.CODE a Taide du LINKER afm d'obtenir le code 
executabJe.[TRAWSPORT,CODE conlient le code des procedures 
MAfNAUX et AUXMAIN ot est disponible sur PURPLE) 




Ces procedures peuvent etre tatales pour votre 
programme et vos donnues si elles sont mal 
employees. En particulier, aucun test de validite 
sur les paramctres passes n'est effectue, 

1'^' cas. Vous voiile^ sduvegarder en memoirt; auxiliaire une variable X 
de n'importe quel type a ladressc ADOR en memoire auxiliaire. 
Vous terez alors Tappel de procedure suivant ; 

MAINAUX(X.SIZE0F(X),ADDRJ: 

2" cas. Vous voulez recuperer dans une variable X ies donnees 
disponibles a I'adresse ADDR en meniopre auxiliairo. Vou& ferez alors 
lappei de procedure suivant , 

AUXMAIN(ADDR,SiZEOF(X].X): 

La gestion des adresses en memoire auxiiiaire est laisseeenliurement 
a I'utJiisateur. ADDR est une adresse qui DOIT elre comprise entre 
S200 ct SBF.FF (attention eveniLfellement aux pages graphfques et a ra 
position des conrimutnteurs associesj, 

ADDR en decimal est done soit compns entre 512 et 32767 ou compns 
entre -33768 et -16365 puisqu'un enlier en Pascal est neceasairoment 
compris entre -32768 el 32767 




Listing des procedures externes MAIINAUX el AUXMAIN 



filL .EQLT 


3C 


*'^IH .EQV 


?D 


fi2L .LDU 


:iF 


ft2H .ECU 


7F 


K4L .im\ 


ir 


MH .EOU 


4"! 


AUXnOVE 


.Etiu [ic^n 


smvB 


.EQU *' 




.PFiDc rwrNflUX.? 




.DEF TRfll^SPORT 




ldy hi 


TRflWSPUhi 


PI B 




STA SMVE 




PLfl 



STfi SflUVE+l 

LDX »7 
LDft fllLjX 
STA SfiUVE*2,.:( 
OEK 

BPL 10 1 

CLD 

PLfi 

STfl «4l 
PLfi 
STfl MH 

PLA 

TAX 

ETft Pt.UBB+1 

PLA 

BIfl PLU5M+I 

TCfl 

BNE «02 
CEt: FLUSK+I 
DFC PLU5B+1 



! 
i 
i 
E 
i 
E 
i 
i 

E 

E 

E 

E 
E 

i53uvegardlp ftl , ft2 .«-q <fl3 est ssiiv^ inuiti lemcntl B 

:ntjra d'Dctehi-l A tj-jmsf ^rer dans PLUE&tl 3t 

: PLLh5H I I — 



[sens de trar^fprt 



fsduvp-gjrrle retaitr Pasiliil 



;iTtise di ij du mode id^timdl 



i ufi dSpiie le rnmhrp d'DctE?t^ ^ tr dnsf ^rer 



E 



PLfi 

CLr 

flUC <lCi 
STfl o?L 

STfl niH 
ftDC HO' 
STfl K\-\ 

PHP 
SEI 

TVA 

RDR ft 

J3R AUXnOVE 

PLP 

LM */ 

L-Dfl EftlJVC+3,X 

STfl fliL.X 

DEK 

&PL »P1 

LDA SAUVE*-! 

PHft 

LDfl SAUVE 

PHfl 

RT3 

.PROC AUXMAtN,^ 

.REF TRANSPORT 

LDV #0 

JUP T((ftwSPDfl!T 



; d*pi 1 erri=nt rje I'sidresee source ^ 
ttrsn-zi^rcr dans A] et ralciil bi? l-a lierri'^rp 
•mOr^m^^ a tran^-fdr^r que 1 ' or SiiLive ddci:^ P(2 



■,s«>a^'::be lea inLeri upliortS 



^•Lsrry ii 1 triirafert vera ii m^iioire 6iii;i I i-S.il'e 
:A]^6cLitiQr fin tren&ferl. 



; rest sijT-?f ion (I* fti,A2,ft3 '?'; A* 



;-fni d'e TRAMSPQRT 



jseng de transfert 



Vri-6 IDENTIFICATION DU MATERIEL 



Ce paragraphe s'adresse aux concepteurs de logiciels, il leur donne 
deux exemples de programmes, le premier en Basic, fe second en 
Pascal qui permettent de reconnaitre ia nature du materiel sur 
iequei va fonctionner leur logiciel. 



VII-6.1 Exemple de progrBmme de reconnaissance 
de la carte eve en Basic 



Le programme lists ci-dessous s'appelle IDENTIFICATION et permet 
de reconnaitre le materiel utilise. Le code est tourni sur la disquette 
Basic DOS 3.3 PURPLESOFT. 



^ 



Par exemple, I'appel du programme suivant permettra d'irnprimer s'il 
est execute 5ur un Apple I! ou un Apple II Plus, 1 s'il est execute sur 
un Apple lie sans carte textc SO colormes dans Is slot auxiliaire, 2 s'll 
est exGCLit6 sur un Apple Ife avec une carle texte 80 colonnes sans 
extension 64K dans le slot auxili^ire. 3 avnc une carte texte 80 colornes 
etendue (64K], 4 avec la carte RVB 80 colonnes etendue (64K) eve 
d'u Chat Mauve. 

10 TEXT'HOME:DS-CHRS(41 

20 PRI^f■| DS:-BLOAD INDENTIF(CATION,AS300" 

30 CALL 768:PRINT(PEEK(975]) 

40 END 




sling de IDENTIFICATION 



CODE .EC!U -CF 



IDEMTIFIC PHP 
CLC 
5^1 



J3B SOMCALC 

STfi SHMME 
STY SDJIME+I 

LEA CiCOBl 

LDA ^coei 

LDA 0FBB3 
CMP #6 
BNE POI 

IWX 

LDA oral? 

BUI Rtjfi 



;irDntiEnt apreb Tapp^'l fte IDENTIFTE : 

; — > 6i non tipple '/e 

f 1 — 1 pas de terte Lw^-ite SC" cojorr^es rl^ans 1* slat 

; auwi 1 iair? 

( 7 -■■; ^arte te^te 30 tolannes dars le Bfat 

5 sui:i li-a: re ^sirj e-^tertHicn 64^ 

( 3 — > rartp tpt:tE 30 cuJuniies ttentJoe (64K1 

J 4 — > csrte RVB BO cnlonrte? i^tEndue &ve du Ctiat 

I Maiivp (fi4KI 

l^jnp^ehii? toiitp irtprruption 

icslcul de D0O0tDlijn*D2ni:i* FFOO 

;partie hiiLite dans V, b-asae rinna B 

irif^iilt^t dfln!i SDUME 

ft 5ert d'ifiirle!: dp recorns,i5Bant.e- 

(lecture ds ]a Ron 

lor teste 1^ signatuire da I 'Apple //e 

;si r^&idtat dilf de t. rp r'e&t pss -.lfi Apple ^ ("e 

iX-1 

[si Icr^ dp 1 'initialisation par BESET eucune cart* 

ji'b 6ti retannue 



!j 

!j 

!j 

!j 

!j 

!j 
!j 

■^ 
!j 



.J 
3 



SS5 


^^ 


^^^ 


93 




t 

■ ^ 












CARTE90 


LDfl OCOlt 

PHB 


i^aLiu^qarde de I'^tdt de HIRES 








LDfl OCOIB 
PHA 


■.^duverjH' de de I'ttdt de SOSTORE 






LDfi OCiMr 








PHO 


ssauveqarrfe de I'Stdt de PftGE2 




L 

1 


ECRftW 


LDA HJiD:il'7 


;on hoH.icle tant qu'cir est vi&Lian^^ 




1-^ 




STfi 0CO57 


: HIRES 0(1 






STA OC^l-OI 


iBfiSTDRF !?n 




L 




STfl 0C0S5 


; sects PflBElX 




L* 




LM in-Oi 
PHfl 


isaKvegsrde tie !-"cctet sitiiB en 4O0 




f 




LDA 2400 

FIW 

LDft ttPEE 
STfl 4C>0 
LDfl 240i'! 


! f^siivpfjardp- *jp 1'nctet sltii^ en Zi^OO 

}or chiirge EE en AOO PfiGElK 

!24iXi est cDr-Fordii nvi^c 41^0 par le hardwdre si liitb 




^ 




CnP HOEE 

BNE ETPraUE 
A5L ^4'>i^ 
LOfl 400 

CnP 2400 
BED HLPM 


; t-^rte te«te sans B5;tpn^: an t4k P5.t pr^sentp 

jon recaitimencE avec une vjjeur diffi^rente an cas du .j 




■ 










L 


ETfNDUE 


INX 


;^=i 




■ 




1 lift t(i"jF 








STA OCOti'^ 


sTEXTIo on et registre automatisiue a OF 




L 




STfl fCOSfl 


jPAGFl 








LDfl 40C 
STfl 4(1 C* 
STA OCOBS 


iTEVTli tif + 




L^ 




ST Pi iTO^a 

LDA 100 

mi Qia?.A 


iPflSEn 

jOEE oiji iiF er 40i> PAGE IK 




P 


DLD24 


INX 

PLC 

STfl 2Wi:i 


■ remise en et^st. 240O 




if 

if 




PLfl 
STfl 400 

Fi_ia 

Bni OLDSTOftE 

STfi fJiC054 


;r?miBe pn et^t de POfi.E? 




if 


OLOETDRE 


PLft 






if 




m: 0LDH1PE5 

STA OCOCO 


iremisB e<i fiUt de 3fiBTDRE 




L-^ 


OLDHIRES 


PLfl 






L 

■ 




HIT ROW 








STfi 0C0S6 


ireffli&e en dtdtt de HIRES 




L 








i 




BNh'l 



BNK? 
FIN 



J5R 50HCAUC 

BNF fiNh'l 
cpy saniiF+i 
BEO FIM 

LDfi ijcoea 

JSR BOrtCfiLC 
CMI-' SGflMF 
BIJE ■eNf2 

FED FIN 
LDfl CCOQO 

57 X CODE 

PUP 

RTS 



LDft »000 

LDA ttO 
tftY 

CLC 

mv 
CE r 

3NE POEJT. 

RTS 

.wnRP oaoo 



: StiorB-rcHP's er ROM ? 



;quplls t>enque ? 






!•*! carry-1 incSnentation partie hiiute ek r^mm^ rtie 
;de la carry fi 

E jy-E-qtj' a ii 



3 



i-fin de lUertif icat ion en S3CC 



V(l-6.2 Exempie rfe fonction de reconnaissance 
de la carte eve en Pascal 

La fonction externe SIGNATURE permet CidBntification du materiel 
utilise en Pascal. Elle retourne si elle appei^e aur un Appie Jl 
ou un Apple II Plus, 1 si eile est appelee sur un Apple /;e sans carte 
texts ao coJonnes dans le sfot auxihaire, 2 si ellc est appelee sur un 
Apple fSQ avec une carte texte 80 colonnes sans extension 64K dans le 
slot auxiliaire, 3 avec une carte texte 80 colonnGs etendue, 4 avec Ja 
carte RVB SO colonnes ctendue {64K) ewe du Ctiat Mauve, 

function SIGNATURE:JNTEGER:e>;temal; 







^^^* 95 ' 


1 


L* 


^ 


N 




% 






X^ 


A 








rm 






£ 


wt 








mr 






Lj 


^HK Listing 


de SIGNATURE 


( 


g 


•** 


1 










1 


.FINL: SIQNftTUKE 


jcetoiirne 




Mm.^^ 




; — ? Si non Apple ''■'e 




L^ 




1 I — '' paa. de carte teste Bti tolonres dan'5 le slot 






; -mni I i aire 








1 2 — > Cflrte tcKte 30 tDlonnefi diins le slot 






; i^uKiliaire sarS eilefisinr &«!<: 






1 :^ — - rartff te>(te SO cclunnes SLfefiduS (MKt 




^hj^ 




; A — > ti^rle WB B<.^ calonreS 6terf)<^» ^ve du Chat 




L^ 




I Mauve (MKl 




PLfl 




■ 


L^ 


FTfl n 

STA 1 


[■sauve^arrte retcur pascal 




L^ 


PLft 








PLfl 






bg 


PLfi 

PLA 


jcorredliun de pile poicr les ■foretiors 












L^ 


PHP 
SEl 

lDV #0 

LOfi ocoa? 


;*nipSch3 tmitB intHrrLiptiort 

;X sert d'lnrfei: de rEcorndi'ssarice 


I 




LDfl OC'^B? 


; lecture de la TOM 


P 


LDA 0FBB5 
enp ttb 


;'On te&te le '^I'gnatLire de 1 'Apple '/e 




SNL PIN 


isi rdgLjlt£,t di f 'f de t, ce r'eat pa& 'jn fipple '''^e 




INX 


; i'-'l 




ta 


LDfi 0C017 


ii^L Lui5 ds 1 'irii tidli&dtiur par RESET ducunc L-arte 




mi FIN 


;n'a *t# recDrrtue 




L 


CfiRTEBO IN)< 


5X-r 




LDA CCOID 






PHfi 


;sdj^e<^erde de l''^tdt de HlREEi 




LDA ocoia 






PHA 


;5aLH/egarris de I'^tst de 8USTDHE 




LDA OCOIC 






PHA 


;3^Lii/eqarde de L'^tat tte Pftl=E2 




5-^ 


ECRf^N LDf^ OCOI^ 


ion hnurie' t^nt qu'cn ■^^t visu^lis^ 




L 


SMI ECftflM 




1 


k 


STA 6CDE7 


;HIR£C on 


1 


STA aCfji-ji 


!Bi:iETDRE on 




5Tfl ncciss 


;afr.fr9 PoGElX 




L, 








Y^ 
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LDft 400 

LDfl Z-^OiJ 
PHA 

I. DA »oe:e 

ETft AOO 
LDA 2400 

Cnp ttflEE 

BtlE ETFN[>UE 
f\BL 2AW 
LDA 400 
CMP 2^0 

BED 0LD24 

ETENDUe I NX 

l-Dft (tJliF 
STfl nCOe*? 
STfl OCO^-I 
LDft 400 
STfi 400 
STA 0C5BB 
STfl 0C055 
LDfl 400 
PMI □LD24 
INX 

□L[i24 PL ft 

5TA 2400 

PLA 

STfl 400 

FLA 

K1I OLCSTDRE 

El ft orns4 

□LUSTQftE PLfl 

PMI OLDHIRES 
STfl OCOOO 

OLDHIRES PLfl 

BMI flN 
ST ft OC-056 



FIN 



LDA OCOSB 

LEA ocoes 

PLf 

LDA #0 

PHA 

TXft 

PHfl 

LDA 1 

L&A 

PHfl 

RTS 

.ENO 



■^ 



ssauvnqarflp do I'octet ^i tu^ er AQO 

rsauveqarOp Op i 'nctet situi^ en 2400 

;an ch*rg* EE efl 400 PflGElK 

;2400 est COnfDrlilJu avec 400 pdr Ip hardware si anp 
icarta tai^te sens e'StenslDn 611.' e&t fjr^s-ejitp 

(on recummente svec i.ine valejr dWf erprite ag qas oij 



sTE^TLi an et registrie autonustifjue a OF 
;PflGEl 



-J 

3 




jTEXrift of-f 
iPftGEl^ 



;540O conMpnt EE ot< OF 
!X=4 



; remi 56 *n ^tat 24fHi 



jrejnibe er ^tst 03 4tK3 



iremibe en ttat rl.p PBBE1-PAGE2 



trenibe en fetat dp onsiriRE 



(remise sn atat tfe HlFfES 



;dihloqi.<e les interr-upLions 



ires-ult-dt d^n^ Id pile 



Sretojr Pascdl 



jfin de stsmmm 




Zones memoire d'affichage 



l-LJ 

l: 
1 


modes de visjalisation 


Pagfi 


Adresss 
de debul 


Ad rnsse 

de fin 


Texte 40 colonnes et 
Graphisme bssse rfisolulion 


1 
2 


$400 
S800 


1024 
2048 


$7FF 
SBFF 


2047 
3071 


L-LJ 


Texleaocolornes 




$400 


1024 


$7FF 


2047 


Graphisme hsute rffsolution 
standard 


1 
2 


S2000 

S4000 


8192 
16384 


$3FFF 
$SFFF 


16383 
24575 


Haute resolution etendue 




$2000 


8192 


$3FFF 


16383 


l: 

E 




Tableau VI hi 









Commutateurs d'affichage 



Nom 



Fonclian 



adresse lecture 

Hex Decimal ecriture 



TEXT "on": &cran texle 

"off": ecran grai&hique 
iirs i'elal de TEXT 

MIXED "on": texts sols graptiique 
"off: ectan tout grapfiique 
lire i'^tat de MIXED 

PAGE2 "on": Afhchage de ia page 2 
"off": Atfichage de la page 1 
lirs i'elal de PAGE2 

HIRES "on"': Graphisme tiaute resolution 
"off": Grsptiisnie basse rnsululion 
lire i'etat de HiRES 

80COI- on ": texfe 30 coionnes 

"off: texte 40 cotonnes 
lire etal de 80COL 



aOSTORE ""on": modifie la fonction de PAGE2 SC001 
"off", (onction uauelie pour PAGE2 
lire retat dc BOSTORE 



SC051 
SC050 

SC01A 


-16303 
-16304 

-16358 


lire 


SC053 
SC052 
SC01B 


-16301 
-16302 
-16357 


lire 


SC055 
SC054 
SG01C 


-16299 
-16300 

-ia35fi 


lire 


$CD57 
$C056 
SC01D 


-16297 
-16^98 
-16355 




SCOOD 
SCOOC 

SCO IF 


-16371 
-16372 
-16363 


ecrire 
ec ri re 

lire 


SC001 

scooo 

SCO IB 


-16383 
-16384 
-16360 


ecrirc 
et:rire 
lire 



Tableau VI 1-2 



F 



98, 



cumuli 



Commutateurs memoires 



Nom 



Fonction 



adresse 
Hex Decimal 



RAMRD "on": lecture 48K aux. 
"off": lecture 4SK lie 
lire I'etat de RAfvlRD 

RAMWRT "on": dcrilLTe flSK aux. 
"off": ecriture 4SK He 
lire retatde RAMWRT 

ALTZP "on ": pile, page O.bank swttclied aux. 
"■off": pile,page O.bank switcf^ed He 
lire I'etat de ALTZP 



$C003 -16381 

SC002 -16382 

SC013 -16365 

$G005' -16379 

$C004 -163B0 

SCO 14 -16364 



$C009 

SCOOS 
$C016 



80STORE "on": acces ^ la page tX par PAGES $C001 
"off: utiJiser RAMRD, RAMWRT $C000 

lire letat de SOSTORE $C018 



PAGE2 "on": acces mem aux 

(51 SOSTORE on) 
"off": Rcc^s mem, He 
Jfre I'etat de PAGE2 

HIRES "on": acces possible page graph. IX 
"off: LtiJiser RAMRD, RAMWRT 
lire rstat de HIRES 



Tableau Vll-3 



-16375 

-15376 
-16362 

-16333 
-163S4 
-16360 



$CD55 -16299 

$C054 -16300 

SCQ1C -16356 

$C057 -16297 

5C056 -16298 

$CQ1D -16355 



lecture 
ecriture 



ecrire 
ecriro 

lire 

ecrire 

ecrire 

lire 

ecrire 

ecrire 

lire 

ecrire 

■Ecrire 

fire 



lire 



lire 












d 



L 



b 



l" 



L 



MEMOIRE APPLE /fe 



Barik 

Switched 

Memorv 



l/D 



Haute Resolution 
Page 2 

Haute R&3olulion 

Page 1 



TeKte Page 2 

TRxtG Page 1 

Pile et Page 



: 



Active 



D 



HAMRD : X 
PAGE2 : oft 




5FFFF 

SDFFF 

SDOOO 
SCFFF 

SCOCCJ 
SBFFF 



£6QC)0 
S4M0 
S2000 

SCOCl 

saoo 

S4f>D 

S1FF 
SO 

Inactive: 



M^MOmE AUXILIAIRE 



Bank 

Switctied 

Mierriory 



D 



RAMWRT : X 

HIRES : o1t 



Haule R'Ssqiulion 

Page IX 



Texts Page 1X 



Pile et Page 



CommJiee 



D 



flDSTORF off 

ALTZP off 



FjQiiie VII-1 : 

ComiTiutations provoquees par RAIVIHD «l RAMWRT lorsqu* SOSTORE est on 



100 



MEMOIRE APPLE //e 



Bank 

Switched 



I/O 



Hauie Resolution 
Page 2 

Haute ReaokJtion 
Page 1 



TcMto Pago 2 
Texte Page 1 

PrJe et Page C 



Aciive 



a 



RAMRD : X 
PAGE2 : off 




SFFFF 

SDFFF 

SDOOO 
SCFFF 

scooo 

SBFFF 



S6000 

S4000 
52000 

SCDO 
5800 

S200 

S1FF 

SO 
Imaciive 



D 



RAMWRT ; K 
HIRES ; on 



MEMOrRE AUXILIAIRE 



Bank 

Switched 

Memory 




a 



3 



-J 

3 
3 



19 



HaHe RcsoJution 

Page ^X 



Texte Page IX 



Pile et Page 



.J 

3 



Commutee 



D 



BOSTORE : on 
ALT2P .otf 



Figure Vii-2 

CommuEelJDns provoquees par RAWIHD fit RAIMWRT lorsque 80STORE et HIRES sant on 



L 



L 



MEMOIRE APPLE /fe 



Bark 

SwUched 

Memgry 



I/O 



Haute Resolution 
Page 2 

iHaute Resotulion 
Page 1 



Tcxte Page 2 
Texte Page 1 

Pile et Page 



Active 



RAMBD : off 
PAGE2 : off 



SFFFF 



SDFFF 

SDCOO 

SCFFF 

SCODO 
SBFFF 



S4oro 

S2000 
SCOO 

$400 

SlFF 

SO 

inactive 



D 



RAMWRT : otf 
HiRES : off 



Figure Vll-3 ; 

Commulslioris provoquees par ALTZP 
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MEMOIRE AUXILIAIRE 



Bank 

Switched 
Memory 




Haute Resolution 

Page IX 



Texte Page IX 



Piie al Page 



Ccmmulee 



D 



easTORE : off 

ALTZP ; X 



I 




^ 



L 












E 



Ei^e ef /e 
langage machine 



I 




ir 



LT 

E 

l1 



105 




CHAPITRE VIII 




Eve et le 
langage machine 



VMI-1 OCCUPATIOMVIEMOIRE 

DU LOGICIEL GRAPHIQUE PURPLESOFT 

VMr-1.0 iFttfoduction 

Le plus grand soin a pAe apporte a celte gestion memoire. En effet, 
la plus grande partie de ce logiciel reside en memoirs auxiljaire se 
conteniant d'une place de IK-octets en memoirs prtncipale et laissant 
done ainsi le maximum de place en memoire princfpale pour fos 
programmes de rutilisateur. 

Ce logiciel est entierement redige dans le langage assembleur du 6502: 
il sl' compose de 3 parlies : 

a) L'inlertace 

Cctle premiere partie occupe IK-octets en m^moire principale E|le se 
situe entre le DOS et ses buffers ou Basic et juste au-dessous de la 
page haute resolution protegee en Pascal, Les variables glDbttlos, 
les appels de sous-programmes, linterpreleur Basic y resident. 

b) Les caracteres graphtques 

Cetle soconde partie occupe SK-octets en memoire auxiliaire darts 
les deux banques paralleiss de 4K situGcs entre les adresses SDOOO 
et SDFFF. Elle peutcontenir ainsi jusqu'&B ensembles de 128 caracteres. 

Le premier est charge dans la banque 1 en SDOOO. 
Le second est charge dans la banque t en SD400. 
Le troisieme est charge dans la banque 1 en SDSOO. 
Le quatn&me esJ charge dans la banque 1 en SDCOO. 
Le cinquieme est charge dans la banque 2 en $DOO0. 
Le sixieme est charge dans la banque 2 en $0400, 
Le septieme est charge dans la banque 2 en $DSOO. 
Le huitieme est charge dans la banque 2 $DCUO. 

c) L'implementation 

Celts troisieme partie contient toutes fes procedures internes 
graphiques el reside en rncrnoirc auxifiaire entre les adresses SEOOO 
et $F1FF. 



VIII-1.1 Cartographic de la gesHon memoire 
MEMOIRE PRINCIF*ALE 



SFFFF 




MEMOIRE AUXILIAIRE l^i« 

$F200 



SEDOO _, 

.^- snooo _^ 







W^ 




^^m 



&CFFF 



BAMK ) BANK 2 



_ adresses SCOBO & SCOBF 



SCOOO (device select slor 5) 



HJMEM 



^^ 



_ $BFFF 



S9D0U 

. 39900 

$9200 



GRAPHIQUE 
Pagcl 





P(LE 
PAGE 2£ro 



^ 



_5400Q . 

_ S20D0 _ 

. SfiOO 
. SlOO 

SIFF 




GRAPHIOUE 
P330 1X 



TEXTE 
Page IX 



50 



fyTTZ:^ PILE 

PAGE ZERO 



/'Z LJlilisupar PURPLESOi-T 



v> 



uliliaK flans Iss motfcs iBrle 



Cd'Hclarpp grapfiiques 



uliliHe dan? Ie& modes EextB 
SO cmun^P.i ou 4D Calor.nEs 



iilrii;i& d£ns Ids 

mcOfis tjrapliiqueE ■■3K'- 



Killing i^ans les 

mofles g!-aFi(iiqLK>s „ IGK' 



GESTION MEMOfRE EN BASIC 



L 
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MEMOIRE PRINCIPALE 



MEMOIRE AUXILIAIRE 





PASCAL 


BIOS 





SFFFF 



BAMK2 BANK 1 




BANK ] BANK 2 
-e-SCFFF 

__adfGS&GS SCOBOi SCOBF 
. SCfiOO [aevice selecl slol 3) 



GRAPHIQUE 
Page T 



TEXTE 
Page I 



PILE 




_3BFFF 



54000 



PILFZfRO V////A 



wzm 



S2000 
El COO 



saoo 

.S400 

.SIFF 
.SO 




GBAPHtOUE \ 

Page IX 



TEXTE 
Page IX 



■ 


V///A 


1 





PILE 

PAGE ZERO 



E 



■'J (^riiise par PUHPLFEOfT 






ij|ili5(>0a'>5lC5 






GESTION MEMOIRE EN PASCAL 
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REMARQUES IMPORTANTES 

— Les adresses $00 k $0B dans la page de la memoire auxiliaire 
sont utilisees de maniere fugitive par ce logiciel. Vous pouvez 
done les utiJiserde maniere provisoire mais n'esperez pasy retrouver 
vos pointeurs apres Cappel d'un sous-programme de PURPLESOFT 

— La pile auxiliaire (page 1) est evidemment utilisee. 

— Tous les modes graphiques -leK- utilisent la page IX (adresses 
S2000 a ?3FFF) en m^moire auxilraire, 

— En Basic, les buffers du DOS sonf translates de IK-octets vers 
le bas en memoire prtocipale pour degager une place pour 
i'interface. 

— En Pascal, la pile des variables pointeurs est remontee a I'adresse 
$4000 pour proteger les adressos inferieures done en particulier la 
page graphique en memoire pnncipale. L'interface est aiors place 
en $1C00, 



VIII-2 DESCRrPTION DE UINTERFACE 

VIII-2.0 Ai^ert/ssemen^ 

Pour mleux comprcndre fe fonctionnement des sous-programmes et 
des variables decrrts ci-dessous, il est conseplle de lire au prealable 

le chapiire V decrivant le logiciel PLfRPLESOFT. 

VIII-2.1 yBfiab\B& desUnees a la lecture et a recriture 



a) Table de commands des coufeurs {16x16 octets) 



— COLORSTAB: 



adr. basic $9900 k $99FF hexa 
adr. pascal Si COO ^ $1CFFbexa 



(-26366 a -26113 dec 
(716B 6 7^23 dec) 



Le p-eme octet (ou p=:Nf+16xO) contient un enliercompris entreO et 15 
qui correspond a la couleur effectivement affichee lors d'un tra?age 
dans la couleur d'encre N sur la couleur d ecran. a conditfon toiitefois 
que la variable OPTTABLE soil non nuile 



- OPTTABLE: 



adr. basic S^A26 hexa 
adr. pascal SI D26 hexa 



(-26074 dsc.) 
(7462 dec.) 

Si cet octet est A 0, la table est inactive sinon elJe est actrvee. 



Options lors d'un changement de mode graphique 



OPTGLEAN: 



adr. Oasic $9A2E hexa 
adr. pascal $1D3E hexa 



(-26066 d&c.) 
(7470 dec.) 



J 

!] 
!j 



.J 
3 






LT 
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- SWITXTGR: 



3c)r. basic S9A30 hexa 
adr. pascal $1 D30 hexa 



c) Variables de passage de parametres 

— PARA1: adr. basic S9A00/ $9AD1 hexa 

adr. pascal $1 DOO / $1 D01 he^a 

— PARA2: adr. basfc $9A02 / $9AQ3 hexa 

adr pascal $1D02 / $1D03 hexa 

— PARA3: adr. basic $9A04 / S9AD5 hexa 

adr, pascal S1D04 / S1D05 hexa 

— PARA4: adr basic S9A06 / S9A07 hexa 

adr. pascal $1D06 / S1D07 hexa 

— ABS1: adr. basic SgAOS / S9A09 hexa 

adr. pascal SlDOa / $1009 Hexa 

— ORD1: adr. basic S9A0A / $9A0D hexa 

adr pascal $1D0A/S1D0B hexa 

— ABS2: adr- basiu $9A0C / $9A0D hexa 

adr. pascal $1 DOC / $1 DOD hexa 

— ORD2: adr, basic $9A0E / JSAOF hexa 

adr^ pascal SIDOE / $1D0F hexa 

d}Abscisse et orcJonn^e du curseur graphique 

— XCURS' adr. ba&C S9A10 / $9A11 hexa 

adr, pascal $1DTD / S1D11 he?;a 

— YCURS: adr, basic 59A12 / S9A13 hpxa 

adr, pascal S1 D1 2 / Si D13 hexa 



(-36064 dec ) 
(7472 dec.) 



-26112/ -26111 dec.) 
(7424/7425 dec.) 

(-261107-26109 dec.) 
(7436/ 7427 d^c) 

-26108 /-26f 07 dec.) 
(7428 / 7429 dec.) 

-26106/ -26105 dec.) 
(7430/7431 dec-) 

(-26104/ -26103 dec.) 
(7432 / 7433 dKC.} 

[-^61027-26101 dec] 
(7434/7435 dec] 

(-26100/ -26099 dec.) 

[7436/ 7437 d6c.) 

(-26098 / -26097 doc ) 
(7438/ 7439 dec J 



(-26096/ -26095 dec) 

(7440/7441 dec.) 

(-26094 / -26093 dec.) 
{;'q42 /7443 deC) 



e) Extensions de lutJIisation du symboile AMPERSAMD 

— NEWlNTERP: adr. basic S9AC6 / $9AC7 hexa (-25914 / ''25913dec.) 

Ces deux octets contiennent usuellcment I'adresse SDEC9 (SYNTAX 
ERROR) on peut y meltre J'adresse dune nouvelle extension 
d'interpreteur utilisant lampersand. 

VIII-2J^ Variab(€S uniquement destinees ^ la lecture 

a) LImites de la fenfitre graphique 



LEFT: adr. basic S9A16 / $9A17 hexa 
adr. pascal $1D16/ $1017 hexa 



(-26090 / -26089 dec. 
(7446/7447 dec.) 

Ces deux ootets contiennent fa limite A gauche dc ia fenetre quf est 
compnse entre et la resoJution maximaie-1 cTu mode graphique 
en vigueur. 
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— RIGHT 



adr, basic S9A18/ S9A19 hexa 
adr. pascal SlDl8 / £1D19 hexa 



[-2600S / -2G[ia? dec. 
(744S/7449 dec.) 



Ces deux octets contiennent la limite a droits de ia fenStre qui est 

comprise untre 1 et la resolution maximale du mode graphique 
en vigueur. 

— BOTTOM: adr. basic 59A1A / S9A3B hoxa (-26066 / -26085 dec.) 

adr. piiscal S1D1A / S1D1B hexa (?450 / 7451 d^C] 

Le premier octet coniient \b bas de la fenetre qui est compris entre et 

191 . ic second doit etre a 0. 

— TOP: adr basic S9A1 C / S91 D hexa (-26084 / -26063 dec.) 

adr, pascal SiDiC / Si DID hexa (7452/ 7463 dec.) 

Lc premier octet conti&nt le haul de (a fenetre qui est comrpis ontre 1 
eet 192, le second doit etre a 0. 

b) Echelle et caracteres graphtques 

— CHARADRESS- adr. basic S&AlE! / $9A1F hexa (-26062 / -26081 dec.) 

adr pascal SIDtE/ S1Dt F hexa (7d&d./7455 dec] 

Ces deux octets contiennent I'adresse du charset courant. 

— XFACTeUR: adr. basic S9A2Q hexa (-26080 dec.) 

3dr pascal S1D20 hexa (7456 dec.) 

Get octet contienl la fycteur de repetition de colonmes qui est comprts 
entre et 127. 



- YFACTEUR 



adr brisic 59A22 hexa 
adr, pascal S1D22 hexa 



(-26076 dec ) 

(7458 dec.) 



Get octet contient Ic facteur de repetition de lignes qui est compris 
entre et 127. 

— CHARKET- adr, basic SgAS'l hexa (-^6076 dec.) 

adr. pascal S1D24 hexa (7460 dec) 

Get octet contient le numero du charset courant entre et 7, 



c) Option de transfert. texte et grahique en vigueur 



- TRANSFERT 



adr. basic S9A28 hexa 
adr. pascal S1D26 hexa 



■26072 dec. 
(74S4 dec. 



Get octet contient le numero de I'option de transfert courante comprise 
enire et 7 



— TEXTWRK 



adr. basic S9A;'A hexa 

adr pascal S1D2A hexa 



[-26070 dec.) 

[7466 dec.) 

Octet contenant le numero du mode texte courant dans 1..6 

(non utilise en pascal). 



- GRAFWRK' 



adr basic S9A2C hexa 
adr. pascal $1D2C hexa 



{ 2saea dec ; 

(7468 dec.) 



5 

!j 
!j 

.J 



.J 



Octet contenant le numero du rnodo graphique courant dans 0..9, 









c 

■-*? 



^ 

b 

e 



p 



d 






I 



ni 




d) Informations couleur 

— COLO'R: adr. basic S9A32 hexa (-26062 d6c 

adr. paac-jil SI D32 hoxa (7474 dec. 

Octet contonant (a couleur de Tencre utilisee dans 0.16, 



— FILLCOL: adr, basic $9A.14 hexa 
adr. pascal S1D34 hexa 



(-26060 rioc. 

(7476 dec, 



Octet contenant la couJeur de tend utilisee dans 0.16- 



— REG: adr. basfc $9A3e hexa 
adr pascal $1036 hexa 



{-26058 dec.) 
(747S dec.) 



Octet contenant i etat du registre couleur de la cprte eve, 



— COLRETURN: adr basjc S9A3S hexa 

adr, pascal S1D3a hnxa 



(-26056 dec.) 
(74&0 dec! 



Octet ou est retournoo Id couleur d un point de T^cran. 



— BACKGROUND: 



ndr. basic S9A3C hesta 
adr. pascal 5TD'iC hexa 



t-26052 dec J 

[7484 dec.) 



Octet ou est retuurnee la couleur des bits a du la cellule concernee 
par le dernier appel de SCREEIMCALL en mode CP280. 



- CPBYTE: 



adr. basic S9A3E hexa 
adr, paaeaf S1D3E hexa 



(-2605D dec 
(74S6 dec. 



Octet ou esl rotourne le contenu de la celkile conccrnee par le dernier 
appel de SCREENCALL on mode CP280- 



- CPCELL: 



adr basic S9A40 hexa 
adr. pascal $ID40 hexa 



(-26048 dec.) 
{7A3B dec I 



Oclct ou est retourne le numero dans .39 de la ceNule concernee 
par !e dernier appc.il de SCREENCALL en mode CP260. 



CPBIT; 



adr. basic S9A42 hex.T 

sdr. pascal 51D42 trexa 



i-26046 dec.l 
(7490 dec) 



Octet oil est retourne le numero du bit dans .6 concerne par le dernier 

appel dc SCREENCALL en mods CP280 



Vlil-2.3 Appels des sous-programmes grsphiques 

Toutes les operations de try<;age et de remplissage soni ovcnlueNement 

affcctces par I'usage de la table de commande des couleurs et Toption 
de Iransfert. Elles nc fonctionnent pas dans les naodes "'BK" 

a) CGLORCALL; Fixe la couleur d'encre a n 

Basic: JSR S9A44 ou CALL-26044 ' Pascal: JSR SI D44 ou CALL (7492) 

Un seul parametre n compris entrs oi 16 est passe dans le mot 
PARAl [attention !!f 16 bits). 



b) BACKCALL Fixe ]a couleur de fond a n. 

B^sic: JSR S9A4A ou CALL-26038 / Pascal: JSR S1D4A ou CALL (7498) 
Un seul pcirametre n compris entre ct 16 est passe dans le mot 
PARAl (attention fll 16 bits). 

c) TEXTCALL: Execute fordre &TEXT n (inutilisable en Pascal) 

Basic: JSR S9A50 ou CALL-26032 

Un seul paramelru n compris entre el 6 est passe dans le mol 
PARAl (attention !!! 16 biis), 

d) GRCALL: Execute Tordre &GR n 

Basic: JSR S9A56 ou CALL-26026 / Pascat: JSR S1 D56 ou CALL (7510) 

Un seul parametre n compris entre et 10 est passe dans le mot 
PARAl (attention !!! 16 bits). 

Remarque imporiantc : Tout appel du sous-programme GRCALL plaoe 

le swilch HIRES dans la posilion on ($C057j pour des rafsons liees 

au tonctionnement du switch SOSTORE (voir APPLE .■■e reference 

manual). 

11 est done impossible par exemple de viaualiser la page basse resolution 

et de travailler simullancment dans les modes graphique "16K". 

e) DOTCALL: Trace un point en x.y 

Basic- JSR S9A5C ou CALL-26020 / Pascal: JSR S1D5C ou CALL (7516) 

Deux paranielfes x cl y respectivemeni passes dans le mot ABS1 et 
le met ORD1 (attention ii! 2x16 bits). 

f) LIMECALL: Trace une ligne de xdep.ydep g xarr.yarr 

Basic: JSR S9A62 OU CALL-26D14 / Pascal: JSR SI D62 ou CALL (7522) 
Quatre parametres xdep.ydep, xarr et yarr respect ivemunt passes dans 
les mots ABS1,QRD1,ABS2 et ORD2 [aitention III 4x16 bits). 

Q) SCREENCALL: Retourne la couleur du point de coordonees x.y 
Basic: JSR S9A68 ou CALL-26aa8 / Pascal: JSR SI D6S ou CALL (7528) 

Deux parametres x et y respectivement passes dans Ig mot PARAl 

et ie mo1 PARA2 (attention !!! 2x16 bits} 

La couleur du point do coordonnees x. y esl relournee dans 

COLRETURN. 

h) FILLCALL. Remplit la fenetre de la coufeur de fond 

Basic: JSR S9A6E ou CALL-26002 /' Pascal: JSR $1 D6E ou CALL (7&34J 

i) CPCALL: Ne fonctionno qu'en mode CP280, ,remplit la page IX de 
la couieur d en ere et de la couleur de fond courantcs 

Basic: JSR S9A74 ou CALL-25996/ Pascal. JSR S1D74 ou CALL [7540) 



!i 












j) WINDCALL Fixe les limites de la fenetro graphique g.d.b et h 

Basic: JSR SSA/A OU CALL-25990 / Pascal: JSR S1D7A ou CALL (7546} 

Quatre paramelres g,d,b et h respectiverrtcnt passes dans les mots 
PARA1,PARA2,PARA3 et PARA4 (attention aux limiles et aux 4x16 bits). 

k) XFRCALL: Fixe I'oplion de transfert a n 

Basic: JSR S3AB0 ou CALL"259a4 / Pascal: JSR SI D80 ou CALL[7552) 

Un seul parametre n compris entre et 7 est passe dans le mot PARA1 

I) SCALECALL: Fixe les echelles de reproduction des caracteres 
graphiques ot des formes (tableau de booleens) 

Basic; JSR S9A89 ou CALL-25975 / Pascal: JSR SI D89 on CALL(7561 ) 

Deu;i( paramtjtres xfact et yfact comprts cntre 1 et 128 respectivement 
passes dans le mot PARA1 et le mot PARA2 (attention !!? 2x16 bits). 

m) DRAWCALL: Trace le tableau de booleen qui commence a 
I'adressG placee dans le mot PARA1 

Basic: JSR S9AeF ou CALL-25969 / Pascal: JSR S1 DBF ou CALL[7567) 

n} CHARCALL: Trace le caractere dont le code ASCII est passe dans 
PARA1 a remplacement du curseur graphique puis 
deplace le curseur pour Iracer eventuellement un 
nouveau cEiraclere 

Basic: JSR S9A9a ou CALL-25960 / Pascal: JSR S1D9S ou CALL(7576) 

o) CHRSETCALL: Fixe lensemble de caracteres de travail au charset 
numero n 

Basic: JSR S9AAE ou CALL-25938 / Pascal; JSR SlOAE ou CALL(759B> 

Un seul parametre n compris entre G et 7 est passe dans le mot 
PARA1 (attention !!! 16 bits}. 

Transfere un nouveau chiarset prealablemeni 
charge S I'adresse placee dans PARAl a la place 
a la place du charset courant. 

Basic: JSR £9AB4 ou CALL-25932 / Pascal: JSR SI DB4 ou CALL(7604) 

q) Plp-fXCALL: Passage d'une page texte a I'autre (1 sur IX) ou vice- 
versa avec aauvegarde des donnees d'entrees-sorlies.. 

Basic: JSR S9ABA ou CALL-25926 / Pascal: JSR $1 DBA ou CALL(7610) 



p} TRANSCHAR; 



VIIF-3 CARACTERES GRAPHlQUES 
VII-3.0 Introduction 

Huit ensembles de 128 caracteres (charsets) sont dispombies Le 
sous-programme CHRSETCALL permet de choisir le numero de 
lensemble de caracteres avec lequel on veut travatller Le snus- 
programme CHARCALL trace le caractere graphique dont ie code 
ASCfl se trouve dans PARAl a Ja position du curseur a t'echelle fixee 
par SCALECALL, Le sous-programme TRANSCHAR permet do 
remplacer Tensemble de caracteres de travail par un autre personnel 
S I utilisateur {caracteres espagnols. suedois. etc..) charge au prealable 
en memopre. 



VIII-3.1 Slwciure dun ensemble de camcteres graphiques (charsel) 

Chaque caractere est organise comme une matrice de 7x8 points et 
utilise 8 octets en memofre, le bit 7 de poids fort de chaqife octet 
etant ignore, Un ensemble de 128 caracteres utilise done T2SxB=1024 
octets (IK-octet) de memoire. 



!j 

3 



exemple: n^bit 7 6 5 4 3 2 10 



octet n" 7 
octet n ' 6 
octet n'^ 5 
octet n'' 4 
octet n" 3 
octet n" 2 
octet n^ 1 
octet n" 



11111 

I 

G 1 

11111 

1 

1 

T 1 1 1 1 







le bit 7 est ignore 



bit correspondant au 
premier point traqe a 
la position du curseur 



De quel caractere bien connu s'agit-il sachant qu'a I'^cran le point 
correspondant au bit de poids faible est le plus a gauche ? 

II sera code en memoire par les 8 octets : 00 3E 02 02 3E 02 02 3E 

Vous pouvez done creer ainsi vos propres caracteres ou mieux creer 
un programme qui fe tasse 'ILou pJus facile utifiser les charsets 
disponibles sur vos disquettes. 

Remarque importante ; La structure des caracteres graphiques n'est pas 
la meme que celie des tableaux de booleens utiiis^e par DRAWCALL 
qui est compactifiee (tous les bils sont utilises) 
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Informations 
techniques 



- IX-1 LES COMMUTATEURS DE LA CARTE EVE 




L'utilisation de ces commutaleurs suppose une bonne 
connaissance de I'Apple ite et de ses cornmulateurs, 
Une mauvaise utilisation peut declencher a I'ecran 
une visualisation surprenante. 

Les commutateurs de la carte eve et ceux de 

. lApple lie fonclionnent de ia meme tagon : une 

a^resse sert a ies brancher (^' on"), une autre a Ics debrancher ("Off "). 
II n'est pas possible de relire letat de ces commutaleurs; a lallumiit^e 
de votre Apple He. ifs sont taus debranches. lis occupent les adresses 
SCOBOa SCOBF [-16208 a -16193) reservees a la carle occupant ie slot 3 
de votre Appie He. 13 faudra ecrire a ces adresses car. a chaque fois la 
donnee sera memoris^e dans un registre de la carte ^ve :CPREG. 

CPREG memorise la couleur dcs paints (en partte basse) et la couleur 
de fond {en partie ha^ne) utihsees dans le rnode toxle couleur et dans 
ie mode graphique CP280 Si CPREG est en fonction (voir a ce sujel 
ia description des autres comrTUiiateurs) son contenu est 
aulomatiquement inscrit en memoire auxiliaire iors d'une ecritiire en 
memoire pnnctpale aux adresses S400-$7FF (page ecran texte) et 
52000-S3FFF (pageecran graphique). 



AN3 . on SC05F 

off SC05E 



-16289 

-1 6290 



Le commutateur AN3 est Impiemonte sur votre Apple He et pcrmel 
lorsqu ii est branchcde visual iser des ecrans graphiques -double haute 
resolution" (utilisant 16K de memoire ecran) avec la carte eve. La 
visualisation de certains modes graphiques -leK" necessite le 
branchemenl deSOCOL: consulter a ce sujel I e tableau IX-T, 

HR1 : on SC0B3 -16205 

off SC0B2 -16206 

HR2 : on SCOBS -16203 
Off SC0B4 -16204 

HR3 : on SC0B7 -15201 
off SC0B6 -16202 
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Le fonctionnement de ces trois curnrTiulateurs depend de I'etat de AN3: 

— Si AN3 est tranche, laffichage gmphjque haute resolution est la 
haute rsjsolulion standard et HRl, HR2 et HR3 en splectionnenl lemode 
de d&codage. Lorsque HR1 est bmiiche les points isoies de couleur 
sur fond bkinc (usueNenrient) apparaissent alors noir; ceci perrnut une 
meilleure Jisibilite des caracteres sur fund bitinc sans heaucoup alterer 
le reste de f'image Lorsque HR2est branche les points isoles da couleur 
sur fond noir (usuellement] apparaissent alors blanc; cecj permet une 
meilleure liaibilite cies t;aracteres sur fond noir mals peut modifier de 
fagon importante le reste de I'image. 

Lorsque HR3 t'st branche les surfaces de couleur (usuellement 

uniformes) apparaissent pointillees horizontalement. On se rapproche 
alors de I'image obtenue sur un moniteur monochrome et ceci peut et re 
plus agrdable lorsqu'il n'y a pas de surface coloree mais uniqucruent 
des structures filaires (pour des animations en trois dimensions par 
exemple). Un cas particuiier : si HR2 ef HR3 sont brandies et Hftl 
debranche Timage est alors visual isee en noir et blanc. 

— Si AN3 esl debranche I'affichage graphique haute resoiution utilise 
alors 16K de memoire (le double) : c'ost la haute resolutnon etendue. Et 
les comnrtutatcurs HRt, HR2 et HR3 permettent de choisir le type 
d'alfichage selon le tableau IX-1 suivant ; 




Choix dun mode graphique 



AM? 


HKI 


HR2 


UR3 


Motic grahiiiut 


Note 


on 


(iff 


off 


oti 


Hauie resolmior standard 




nil 


rtil 






|IH sid 1 pi5 lioirs !iin;l Ijlart: 




on 




on 




IIR yd i pl>< blHn:!^ hirnl nnjr 




on 






tin 


HR .iiti + lii>ri/cniia!es poiniilldcs 




on 


off 


oil 


till 


HR Md cj] nciir d blanc 





off oil Od off COLHO (140 prs.ligiii^. rf. ciml.t 

off on off off C0!-3K(1A (2«(lpis,Ligjie, 4ccuL.) 

off uff nil Hff C:OL2H(JM2«0pis.ligne. 4coul| 

iifl 1171 tin otf icran bloquc an noir 

ofl oil on on RW.'i^O S560 plh,' ligrio, noir el bJanc) 

off on iin on rP2R(H2K;0 pis,, ligne. 16 eoul.-lim.) 3 

No!(! [ ■ RdCOI. doii eitc brjinchc (on) pour otKenir edit visuaiisatiiiii. 
Note 2 : Si LOfKCPKLO esi debrancbt a FSHRCPRRCi branche. tPKtO est alors 
cn faniion. 

'lableau IX- 1 



J 
"j 



J 

J 
1 



^ 

E 

L? 



f 



f 



■-1^ 



k^ 






h 



C 
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TXTIfi : on SC0B9 -16199 
off SCOBS -16200 

Si TXT16 est branche et 80COL debranche, I ecran texte 40 ctilunnes 
usuel est alors remplace par un ecran texte couleur oii pevjvent etre 

choisies individuellement la couleur do chaque caractere et ceHe du 
fond sur lequel il est affichc. A chaque caractere de la page ocran lexte 
correspond un octet en memoire auxiliairc (a la meme adressej qui 
ropresente alors ses couieurs (points et fond) a Tecran. Si TEXT16 est 
branche et LOCKCPREG debranche. le contenu de CPREG est 
aulorrialiquement inscrit en mqmoire auxiliaire lors de renvoi a I'ecran 
texte d'un caracterc>. 

LOCKCPREG : on SCOBD -16195 
off SCOBC -15196 

LOCKCPREG, lorsqu'il est branche bloque lolalement le 

lonctionnement de CPREG (plus decriture automatique en memoire 
auxiliaire en texte couleur et en mode graphique GP2aG). 

ENHRCPREG ; on SC0B1 -16207 
off SCOaO -16208 

ENHRCPREG lorsqu'il est debranche bloque le lonctionnement dc 

CPREG mais uniquement sur I'espace memoire 52000- $3FFF 

correspondi-inl a I'ecran haute resolution graphique. Si TXT16 est 

branche (el LOCKCPREG debranche) CPREG continue de fonctionner 

sur I'espace memoirs; S4D0-S7FF {ecran texte). 

ATTENTION . ENHRCPREG doit etre debranche lorsque AN3 est 

branche 

TXTGREEN : on SCOBS -15197 

off SCOBA -16196 

TXTGREEN lorsqu'il est branche remplace la visualisation 

monochrome blanche des ecrans lexte 40 et 80 colonnes par une 
visualisation monochrome vortc;. 



LOCKRES : on SCOBF 
off SCOBE 



-16193 

-16194 



Lorsque LOCKRES est debranche tout <'Ctrl-Resel > debranche 
tous les commutateurs de la carte eve (la carte etant ainsi remise dans 
son etat a I'allumage de I'Apple He). Brancher LOCKRES permet de 
soustraire ta carte eve a cette action < Ctrl-Reset > . 



IX-2 LES CONNECTEURS DE LA CARTE EVE 

Sur la carte eve il y a trois connecleurs : 

— un connecteur 8 broches destmee au raccordement sur la pnse 
P£RITEL d'un televiseur 
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5 P 



haut 



bas 



pin 

pin 
pin 
pin 
pin 
pm 
pin 
pin 



Commutation rapide (2 Volts.. 75 Ohms) 

Signal audio (son) 

Synchronfsation composite negative (75 Ohms, 5 Volts) 

RouyG (75 Ohms. ajustabJe de a 0.7 Volts) 

Vert (75 Ohms, ajustablc ds a 0.7 Volts) 

Bleu (75 Ohms, ajustable de a 7 Volts] 

Masse (0 Volts) 

Alimentation 12 Volts (commutation lente) 



ZJ 

!j 



Ces signaux sort compatibies a^ec certains moniteurs RVB a entrees 
anaJogiquKS- 



Bien verifier tout de mome si vous desirez brancher un 
moniteur RVR, particulierement au niveau de la 
synchronisation. II ne restera alors qu'a trouver ou 
fabnquer fe cable necessaire. Deux brynchements 
sont possibles : sur notre cable a I'aide d'uno prise 
PERITEL femelJe ou sur le connecteur D 9 brochea 
ulilise sur le panneau arriere; tous les signaux decrits 







ci-dessus sy retrouvent dc la fagon suivante : 



5 
4 
3 
? 

1 



pin 1 


Mon connccte 


pi'n 2 


Masse 


pin 3 


Vert 


pin 4 


Synchronisation 


pin 5 


Commutation rapide 


pin 6 


12 Volts 


pin 7 


Bleu 


pin a 


Rouge 


pin 9 


Audio fson) 



^ 
^ 



Connecteur D 9 broches 






t, 



^ 



^ 









^ 



l: 
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20 I 
18 I 
16 I 
14 I 
I2I 
10 I 

al 

6 I 
4I 
3 I 



21 

I 19 
1 17 
1 15 
1 13 
1 11 
I9 
I7 

Is 

I3 
I1 



pins 2 et 6 : Audio (son) 

pin 7 : Bleu 

pin S : 12 Volts 

pin 11 ; Vert 

pin 15 : Rouge 

pin 16 : Commutation rapide 

pin 17 : Masse 

pin 20 : Synchronisation 



Prise PERITEL 



— un connecteur 10 broches regroupant toutes les tensions 

d'alimentation, la synchronisation composite negative a un niveau 
T.TL.LS et Tinformation couleur sous la forme do 4 bits (niveau 
T.T.L.LS). Ces sorties sont identiques aux sorties RVB de I'Apple HI 
et permettent le branchement sur tout moniteur qui peut se connecter 
sur ['Apple III- Un cSble permetfant de passer du connecteur ID broches 
de la carte eve a un connecteur D 15 broches identique a ceiui de 
TApple /// pent alors eire necessaire. 

haut 

• pin 1 ; - 12 Volls (alimentation) 

• pin 2 ; - 12 Volts (alimentation] 

• pin 3 : - 5 Volts (alimentation) 

• pin 4 : Synchronisation {niveau TT.L LS) 

• pin 5:5 Volets (alimentation) 

• pin 6 : Masse 

• pin 7 : XRGBl (information couleur. bit de poids faible) 

• pin 8 : XRGB2 (information couleur) 

• pin 9 : XRGB4 (information couleur) 

• pin 10 : XRGB8 (information couleur, bit de poids fort) 
bas 
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- un connecteur 2 broches destine au raccordGment du son de votrc 
Apple He ii la carte eve pour une eventueile sortie audio sur votre 
tefeviseur. 



ATTENTION : He pas felier a un autre connecteur 
que le J18 SPEAKER de votre Apple He 




5 
^ 



d 
^ 

U 



i 



k. 



^ k 



u l: 



5-^ 



b 



*-5 

l: 
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— APPENDICE 



Compatibllite entre les unites Pascal 
Purplegraphics fevrier 83 etjuillet 83 



A-1 PRESENTATION 

La nouvelle unite PURPLEGRAPHICS (juiliet 83) est plus performante : 

— Elle occupe en memoire principale une place reduite permetlant 
I'elaboration de programmas beaucoup plus long, 

— Certaines erreurs ont ete corrigees, 

— Certaines procedures ont ete siipprimees, de nouvelfes ont ete 
creees. 

— La structure des images sauvegardees sur disque a ete modifJee pour 
etre directement compatibles avec les images conqjues sur Tordinateur 
Appki HI 

— Huit ensembles de caracteres graphiques sont disponibJes sans 
ncGGH disque parliculier. 



A-2 NOUVELLES PROCEDURES 

procedure CHARSET(N:INTEGER) , 
procedure LOADCHAnSETfSSTRING) ; 
procedure CLiEANOPTI0N[C BOOLEAN] ; 
procedure TEXTBG; 
procedure TEXTBW; 

Cinq variables predefimes ont ete ajoutees : 

CPFOREGND:C0LORTYPE 

CPBACKGNDCOLORTYPE 

CPCELLINTEGER 

CPBIT:fNTEGER 

CPBYTEiPACKED ARRAY [0..6] OF BOOLEAN 



A-3 PROCEDURES SUPPRIMEES 

ERASE : n'a pfus aucune utilite, la procedure GRAFIXMODE 

ayant ete amelioree (I'enlever de vos programmes) 

INiTGRAFIX : toutos les ionctions de celte procedure sont 

accessibles separement par d'autres procedures 

SYSTCHARSET : equivatente a CHARSET (0) 

ALTCHARSET : equivalente a CHARSET (1) 



! 
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A-4 MODIFICATIONS DE FONCTIONNEMENT 

La fonction DOTCOLOR en CP280 retourne la couleur du point d'ecran 
el initialise les variables predefmies CPFOREGND.CPBACKGND 
CPCELL.GPBIT et CPBYTE. 

Les procedures GLOAD et GSAVE manipulent des fichiers structures 
difforemments : les 16 prumiers blocs correspondent a la mfimoirt] ecran 
graphiquesftueeen memoiip auxiliaire et les ^5su\^csa la partiesituee 

en memoire pnncipale. Avant la sauvegardo GSAVE place en S2078 et 
$2079 des code5 correspondaniK au mode grapJiiquc utilise et en 
S207A une signature du logictel PURPLEGRAPHICS. Ces fichiers sont 
compatibles avec les fichiers dc type FOTO crees sur ordinateur 
Apple /// dans les modes graphiqties COL140 et BW560 
Note : Lc programme MODFOTO sur PURPLE; permet de modrfier vos 
anciens fichiers de type FOTO pour les rendre compatibfes avec la 
nouvelle unite- 
La procedure WINDOW n'agit plus sur la fenStre s'il y a srreur dans les 
valeurs des param^res- 



A-5 RECOIWPILATION 

Pour etre utiiisable avuc la noLrvelle unite (juillet 83], tous les 
prografiimes crees avec I'ancicnne (fevrler 83}. doivent etre recompiJes 
avec cette nouvellc unite dans la bibliotheque. 

Qiielques legeres modifications peuvent etre necessaires dans le lextc 
du programme pour Eenir compte des changements decrits ci-dessus. 
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p Addentum 



L 
L 
L 
L. 

L 

l: 

1^ 



^ 






1. Emploi du commutateut PAGE2 

II est deconseille d'utiliser directement le commutateur PAGE2 pour 
acceder a une page IX, ceci posant souvent des problemes aj niveau 
des entrees-sorties. A ce propos. le petit programme au chapitre VII 
est destine a expliquer le fonctionnement de PAGE2 mais est un tres 
mauvals exemple do programmation. 

Le sous-programme PiPlXCALL (cf cJiapitre VIIJ) permet la commu- 
tation d'une page memoire a I'autre avec sauvegarde des donnees 
d'entrees-sorties. 



2. Informations comptementaires st/r PURPLESOFT 

Si vous utilisez le logidel PUi=?PLESOFT, I'iristructfon PR-* 3 doit etre 
evitee au profit de &TEXT5 ou &TEXT6. 

All chargement du logicie! PURPLESOFT par le programme HELLO 
OU par une instruction BRUM PURPLESOFT. I'espace memoire entre 
les adresses $1E0Q et $5600 est utilise de maniere provisoire. Cette 
initialisation peut done detruire une partie de vos programmes et de 
vos donnees. De plus, la page graphique 1X (en memoire auxiliaire) 
est alors nettoyee. 



3. tnformations compte mentaires Sur t'unitB PURPLEGRAPHICS 

La valeur 17 est retourn^e dans la variable predefinie lOERROR si 
le fichier utilise paries procedures GLOAD, GSAVE ou LOADCHARSET 
n'a pas une taille normafe, 

Les fichiers de type FOTO crees sur I'Apple /// par I'unite PGRAF sont 
directement compatibles avec I'unite PURPLEGRAPHICS s'ils ont ete 
crees dans le mode BW560. Les images creees en mode CP28a ou 
COL140 peuvent etre rendues compatibles en executant le programme 
MODFOTO. 



4. Caract^res en mode graphique CP280. 

Compte tenu des limitations de ce mode, il est fortement conseille de 

positionner le curseur avec une abscisse multiple de 7 pour dessiner 
des caracteres ou des chaines de caracteres et de ne pas utiliser 
I'option de transfert. 
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5. Tabulation en mode texie BO colonnes 

Certains problemes de tabulation peuvent apparaitre en 80 colonnes 
HTAB ne doit pas §tre utilise et POKE 36,X peut etre rempJace 
fen 80 colonnes seulennent) par POKE 1403,X. 



6. Appels tie sous-programmes graphiques 

Les parametres des sous-programmes documentes aux chapitres V et 
VIII doivent etre initialises JUSTE AVANT leur appeJ. Par example 
en Basic, le(s) POKE{s) doivent etre places juste avant le CALL, 



7. Programme Information 

Hoiis vDus rappelons que le programme basic INFORMATION sur la 
disquette PURPLESOFT (DOS 3.3), est con^u pour vous presenter 
toutes les precisfons n'ayant pu §tre impnmees dans notre 
documentation. En juiJIet 1983, ce progran^me expliquait ceci : 

— Si vous utilfsez directoment le commutateur PAGE2, notez bien 
que toutes les instructions el routines de PURPLESOFT d^faranchent 
cecommutateur (position "Off") Tenez-en compte pour i elaboration 
de vos programmes. 

— Le fichier PURPLESOFT est dote d'un chargement rapide. 
PURPLESOFT etfectue le chargement rapide puis execute 
PURPLESOFT* qui contient toutes les routines grapiiiques Les 
fichiers PURPLESOFT et PURPLESOFT* ne doivent pas §tre copies 
autrement que par le programme COPYA. Vous pourrez ensuite 
effaccr par un ■< DELETE - les fichiers qui ne vous sont pas necessaires. 

A ce propos, Jes huit premiers "charset'= sont deja contenus dans le 
ftchier PURPLESOFT* et leur presence sur la disquette nest pas 
necessaire pour rexScutfon de vos programmes (il en est de meme en 
Pascal). 

— Les programmes basic GRLOAD et GRSAVE, destines au 
chargement et a la sauvegarde d'images graphiques sur disque, 
peuvent etre utilises du clavier avec la sequence suiuante 

LOAD GRLOAD Ou LOAD GRSAVE 
10 N$ - ^-nom de votre Image^' 
RUN 

l^ais vous pouvez aussi inserer les quelques lignes de ces programmes 
cfans les votres. Ces sous programmes utilisant le DOS 3.3 sonl assez 
lents. Si vous desirez un ctiargemen) rapide de vos images graphiques, 
programmez plutot en langage Pascal [ctiargement environ dix fois 
plus rapide). 
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8: Dlffemnces entre hs tb visions A et B tie la carte eve 

Des rucentes informaiions sur le comportemenl de la Double Haute 
Resolution graphique sur des Apple lie americains, en cauleur, par 
la sortie video NTSC, nous ont amenes a modifier tres legerement la 
carte eve et ses logiciels. 

La visualisation couleur aux £tats-Unis, en Double Haute Resolution, 
est voisine du mode graphique 16 couleurs COL140 de Is carte eve 
revision A mais avec une mauvaise correspondance des couleurs La 
carte eve revision B respects cette correspondance et assure ainsi 
une compatibilite plus grande avec de futurs logiciels con^us aux 
£tats-Unis pour la double haute resolution couleur. 

Cette modification conceme uniquement la repartition des couleurs 
dans le mode graphique COL140- Les clients possesseurs d'une carle 
eve revision A et desireu^t de modifier celle-ci peuvent nous contacter 
pour acheter un kit de modification. 

Pour assurer une totale compatibiJite avec des images con^ues en 
mode COL140 sur Apple III ou sur Apple lie avec nos l^ogicieis 
revision A (Juillet et Fevrier 83) le programme Pascal MODFOTO a 
ete compl^t^. En Basic, vous pourrez taper et utiliser les quelques 
lignes suivantes pour modifier les couleurs d'une image affichee a 
I'ecran en mode COL140 : 

10 FORI=0TO 15 

20 READ A 

30 POKE — 26368 + 16--^ l,A 

40 NEXT I 

50 POKE— 26074, 1 

60 & BACK = 

70 & CLEAR 

80 POKE— 26074,0 

90 FOR l=:0TO 15 : POKE — 26368+ 16* I, I : NEXT 

100 DATA 0,8, 1,9, 2. 10, 3, 11.4,12.5. 13,6. 14, 7, 15 

Ces lignes de programme donnent un exemple d'utilisation de l3 table 
de commande des couleurs. 



9. A ratlention des concepteurs de logiciel 

Les concepteurs de logiciels desireux de commercialiser un produit 
utilisant le mode graphique COL140 peuvent nous contacter au sujet 
de ces problemes de couleurs entre les carles ewe revision A et B. 



